DOC-03: Nasazení, bezpečnost a uvedení do provozu
Taktický postup a osvědčené bezpečnostní postupy pro přidělování lokálních oprávnění, neměnnou generaci tajemství a řízený start stacku Redmine.
1. Správa oprávnění (Kritický krok v Linuxu)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»Na rozdíl od jiných souborových systémů v testovacích prostředích vyžadují svazky namontované uvnitř kontejnerů v korporátních prostředích Linux přísné přiřazování vlastnictví a oprávnění pro zajištění bezpečnosti. Interní engine Redmine spouští své vlákna pod izolovaným systémovým uživatelem s identifikátorem (UID/GID) 999.
Pokud vynecháme změnu vlastníka na hostiteli Ubuntu, aplikace se spustí, ale okamžitě selže při pokusu o zápis příloh, kompilaci vlastních stylů nebo zápis logů, což způsobí tiché výjimky v databázi.
Před inicializací infrastruktury spusťte příkaz pro úpravu oprávnění z pracovního adresáře v terminálu hostitele:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING]\r Seguridad de Acceso: Bajo ningún concepto asignes permisos permisivos globales del tipo
chmod -R 777sobre estas carpetas en entornos empresariales. Esto abriría vectores de vulnerabilidad graves para inyección remota de ficheros si algún plugin de Redmine presentase brechas de seguridad.
2. Neměnné generování tajemství (Relace Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine ukládá session tokeny šifrovaným způsobem v cookies klienta pomocí deklarativního klíče SECRET_KEY_BASE. Aby se zabránilo převzetí relace nebo škodlivé interceptaci v prohlížeči, musí být tento klíč vysoce entropický a musí zůstat zcela neměnný a tajný.
Pokud v budoucnu budete potřebovat klíč přegenerovat z důvodu pravidelného auditu kybernetické bezpečnosti, spusťte příkaz pro bezpečnou kryptografickou náhodnost:
openssl rand -hex 64Zkopírujte výsledný alfanumerický blok a okamžitě aktualizujte proměnnou SECRET_KEY_BASE ve svém souboru docker-compose.yml před restartem stacku.
3. Spuštění stacku
Sección titulada «3. Puesta en Marcha del Stack»Pro kompilaci, strukturování a spuštění izolovaných síťových závislostí a perzistentních kontejnerů v režimu démona (na pozadí):
cd ~/redminedocker compose up -dDocker Compose automaticky vytvoří virtuální sítě, připojí nakonfigurované svazky a počká, až bude databázový stroj MySQL připraven k inicializaci SQL struktury Redmine.
4. Diagnostika stavu a trasování logů
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Zajistěte správné spuštění služeb pomocí taktických ladicích příkazů:
4.1. Ověření aktivních kontejnerů
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psKritérium úspěchu: Oba kontejnery (redmine a redmine_db) musí zobrazovat stav Up nebo healthy.
4.2. Audit trasování v reálném čase
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Pro analytické monitorování procesu inicializace databáze a interní migrace tabulek prováděné pomocí Rails:
docker compose logs -f redmineSalida Esperada: Busca al final del flujo el registro de sockets activos:\r
Listening on 0.0.0.0:3000 (el cual es mapeado externamente al puerto seguro corporativo 5588).
5. Řešení běžných problémů (Troubleshooting)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. Kontejner se dostal do smyčky restartů
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- Časté příčiny:
- Chybějící oprávnění vlastníka v hostitelských sdílených adresářích (vynechání příkazu
chown). - Chyby v syntaktickém odsazení v souboru YAML
docker-compose.yml.
- Chybějící oprávnění vlastníka v hostitelských sdílených adresářích (vynechání příkazu
- Řešení: Zastavte motor (
docker compose down), zkontrolujte podrobné chybové logy socketu pomocídocker compose logsa znovu spusťte opravu oprávnění pomocíchown -R 999:999.
5.2. Chyba připojení k databázi
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Častá příčina:
- Název přiřazený v proměnné
REDMINE_DB_MYSQLpřesně neodpovídá deklaraci názvu služby v souboru Compose.
- Název přiřazený v proměnné
- Řešení: Otevřete soubor orchestrace a ověřte, zda oba bloky sdílejí jednotný DNS identifikátor:
redmine_db.
📊 Checklist úspěšného nasazení
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Správné vlastnictví souborů: Všechny namontované adresáře jsou nakonfigurovány s UID/GID
999, aby se zabránilo výjimkám zápisu. - ✓ Robustní session sekrety: Proměnná
SECRET_KEY_BASEvygenerovaná pomocí OpenSSL a izolovaná od veřejných prostředí. - ✓ Aktivní síťové sockety: Bezpečné mapování na portu
5588správně odpovídající s přesměrováním Rails logů. - ✓ Propojená orchestrace: Hlavní aplikační služba blokována před okamžitým spuštěním pomocí direktivy
depends_onaž do úspěšné inicializace MySQL.

