Ir al contenido

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.

0lecturas

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:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo 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 777 pre 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:

Ventana de terminal
openssl rand -hex 64

Kopírujte výsledný alfanumerický blok a okamžite aktualizujte premennú SECRET_KEY_BASE v súbore docker-compose.yml pred reštartom stacku.


Na kompiláciu, štrukturovanie a zdvíhanie závislostí izolovaných sietí a kontajnerov perzistencie v režime démona (pozadie):

Ventana de terminal
cd ~/redmine
docker compose up -d

Docker 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.


Zabezpečte správne uvedenie služieb do prevádzky pomocou taktických príkazov ladenia:

Ventana de terminal
docker compose ps

Kritérium úspechu: Oba kontajnery (redmine a redmine_db) musia zobraziť stav Up alebo healthy.

Na analytické monitorovanie procesu inicializácie databáze a vnútornej migrácie tabuliek vykonanej Rails:

Ventana de terminal
docker compose logs -f redmine

Oč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)»
  • Č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.
  • Riešenie: Zastavte engine (docker compose down), skontrolujte podrobné chybové protokoly socketu pomocou docker compose logs a znovu spustite opravu povolení pomocou chown -R 999:999.
  • Častá príčina:
    • Priradený názov v premennej REDMINE_DB_MYSQL sa presne nezhoduje s deklaráciou názvu služby v súbore Compose.
  • Riešenie: Otvorte súbor orchestračného a skontrolujte, či oba bloky zdieľajú jednotný identifikátor DNS: redmine_db.

  • ✓ Správne vlastníctvo súborov: Všetky nakonfigurované pripojené adresáre s UID/GID 999 na zabránenie výnimiek zápisu.
  • ✓ Robustné tajomstvá relácií: Premenná SECRET_KEY_BASE vygenerovaná pomocou OpenSSL a izolovaná z verejných prostredí.
  • ✓ Aktívne sockety siete: Bezpečné mapovanie na porte 5588 sprá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_on až do úspešnej inicializácie MySQL.