Ir al contenido

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.

0čtení

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:

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

Ventana de terminal
openssl rand -hex 64

Zkopí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.


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í):

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

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


Zajistěte správné spuštění služeb pomocí taktických ladicích příkazů:

Ventana de terminal
docker compose ps

Kritérium úspěchu: Oba kontejnery (redmine a redmine_db) musí zobrazovat stav Up nebo healthy.

Pro analytické monitorování procesu inicializace databáze a interní migrace tabulek prováděné pomocí Rails:

Ventana de terminal
docker compose logs -f redmine

Salida 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)»
  • Č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.
  • Řešení: Zastavte motor (docker compose down), zkontrolujte podrobné chybové logy socketu pomocí docker compose logs a znovu spusťte opravu oprávnění pomocí chown -R 999:999.
  • Častá příčina:
    • Název přiřazený v proměnné REDMINE_DB_MYSQL přesně neodpovídá deklaraci názvu služby v souboru Compose.
  • Řešení: Otevřete soubor orchestrace a ověřte, zda oba bloky sdílejí jednotný DNS identifikátor: redmine_db.

  • ✓ 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_BASE vygenerovaná pomocí OpenSSL a izolovaná od veřejných prostředí.
  • ✓ Aktivní síťové sockety: Bezpečné mapování na portu 5588 sprá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_on až do úspěšné inicializace MySQL.