DOC-03: Nasadenie, bezpečnosť a uvedenie do prevádzky
Taktický postup a bezpečnostné osvedčené postupy pre poskytovanie lokálnych povolení, generovanie nemenných tajomstiev a kontrolovaný štart stacku Redmine.
1. Správa povolení (Kritický krok v Linuxe)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»Na rozdiel od iných systémov súborov v testovacích prostrediach, pripojené objemy v rámci kontajnerov v podnikových prostrediach Linux vyžadujú prísne prideľovanie vlastníctva a povolení, aby sa zabezpečila bezpečnosť. Interný engine Redmine vykonáva svoje vlákna pod izolovaným systémovým používateľom s identifikátorom (UID/GID) 999.
Ak vynecháme zmenu vlastníka na hostiteľovi Ubuntu, aplikácia sa spustí, ale ihneď zlyhá pri pokuse o zápis súborov, kompiláciu vlastných štýlov alebo vypúšťanie protokolov, čo spôsobí tiché výnimky v databáze.
Pred inicializáciou infraštruktúry spustite príkaz na upratanie povolení z pracovného adresára v termináli hostiteľa:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] Bezpečnosť prístupu: Za žiadnych okolností nepridajte globálne povolenia typu
chmod -R 777pre tieto priečinky v podnikových prostrediach. Tým by sa otvorili cesty pre zraniteľnosť pre vzdialenú injekciu súborov, ak by niektorý plugin Redmine obsahoval bezpečnostné chyby.
2. Generovanie nemenných tajomstiev (Sesie Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine ukladá tokeny relácie šifrovane v cookies klienta pomocou deklaratívneho kľúča SECRET_KEY_BASE. Aby sa zabránilo únosu relácií alebo škodlivému zachyteniu v prehliadači, tento kľúč musí byť vysoko entropický a udržovaný úplne nemenný a tajný.
Ak v budúcnosti potrebujete regenerovať kľúč v dôsledku pravidelného bezpečnostného auditu, spustite príkaz bezpečnej kryptografickej náhodnosti:
openssl rand -hex 64Kopírujte výsledný alfanumerický blok a okamžite aktualizujte premennú SECRET_KEY_BASE v súbore docker-compose.yml pred reštartom stacku.
3. Uvedenie do prevádzky
Sección titulada «3. Puesta en Marcha del Stack»Na kompiláciu, štrukturovanie a zdvíhanie závislostí izolovaných sietí a kontajnerov perzistencie v režime démona (pozadie):
cd ~/redminedocker compose up -dDocker Compose automaticky vytvorí virtuálne siete, pripojí nakonfigurované objemy a počká, kým engine databáze MySQL nebude pripravený na inicializáciu SQL štruktúry Redmine.
4. Diagnostika stavu a záznamy logov
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Zabezpečte správne uvedenie služieb do prevádzky pomocou taktických príkazov ladenia:
4.1. Overenie aktívnych kontajnerov
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psKritérium úspechu: Oba kontajnery (redmine a redmine_db) musia zobraziť stav Up alebo healthy.
4.2. Audit záznamov v reálnom čase
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Na analytické monitorovanie procesu inicializácie databáze a vnútornej migrácie tabuliek vykonanej Rails:
docker compose logs -f redmineOčakávaný výstup: Hľadajte na konci toku záznam aktívnych socketov:
Listening on 0.0.0.0:3000 (ktorý je externě mapovaný na bezpečný podnikový port 5588).
5. Riešenie bežných konfliktov (Troubleshooting)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. Kontajner vstupuje do cyklu reštartov
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- Časté príčiny:
- Chýbajúce povolenia vlastníka v zdieľaných adresároch hostiteľa (vynechanie príkazu
chown). - Chyby syntaktickej indentácie v súbore YAML
docker-compose.yml.
- Chýbajúce povolenia vlastníka v zdieľaných adresároch hostiteľa (vynechanie príkazu
- Riešenie: Zastavte engine (
docker compose down), skontrolujte podrobné chybové protokoly socketu pomocoudocker compose logsa znovu spustite opravu povolení pomocouchown -R 999:999.
5.2. Chyba v pripojení k databáze
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Častá príčina:
- Priradený názov v premennej
REDMINE_DB_MYSQLsa presne nezhoduje s deklaráciou názvu služby v súbore Compose.
- Priradený názov v premennej
- Riešenie: Otvorte súbor orchestračného a skontrolujte, či oba bloky zdieľajú jednotný identifikátor DNS:
redmine_db.
Checklist úspechu pri nasadení
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Správne vlastníctvo súborov: Všetky nakonfigurované pripojené adresáre s UID/GID
999na zabránenie výnimiek zápisu. - ✓ Robustné tajomstvá relácií: Premenná
SECRET_KEY_BASEvygenerovaná pomocou OpenSSL a izolovaná z verejných prostredí. - ✓ Aktívne sockety siete: Bezpečné mapovanie na porte
5588správne reagujúce s presmerovaním protokolov Rails. - ✓ Prepojená orchesterácia: Hlavná aplikačná služba zablokovaná od okamžitého spustenia pomocou direktívy
depends_onaž do úspešnej inicializácie MySQL.

