Ir al contenido

DOC-03: Despliegament, Seguretat i Posada en marxa

Procediment tèctic i bones pràctiques de seguretat per al aprovisionament de permisos locals, generació immutable de secrets i inici controlat de l'stack de Redmine.

0lectures

A diferència d'altres sistemes de fitxers d'entorns de prova, els volums muntats dins de contenidors en entorns Linux corporatius exigeixen una assignació estricta de propietat i permisos per garantir la seguretat. El motor intern de Redmine executa els seus fils sota un usuari del sistema aïllat amb l'identificador (UID/GID) 999.

Si omitim el canvi de propietari a l'host d'Ubuntu, l'aplicació s'arrancarà, però fallarà immediatament en intentar escriure fitxers adjunts, compilar fulls d'estil personalitzats o volcar traces de logs, provocant excepcions silencioses en la base de dades.

Abans d'inicialitzar la infraestructura, executa el comand de sanejament de permisos des del directori de treball a la terminal de l'host:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo chown -R 999:999 files themes plugins mysql_data config

[!WARNING] Seguretat d'Accés: En cap concepte assignis permisos permisius globals de tipus chmod -R 777 sobre aquestes carpetes en entorns empresarials. Això obriria vectors de vulnerabilitat greus per a injecció remota de fitxers si algun plugin de Redmine presentés brexes de seguretat.


2. Generació Immutable de Secrets (Sessions Rails)

Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»

Redmine emmagatzema els tokens de sessió de manera cifrada en les cookies del client mitjançant la clau declarativa SECRET_KEY_BASE. Per evitar el sequestre de sessions o la intercepció maliciosa al navegador, aquesta clau ha de ser d'alta entropia i mantenir-se completament immutable i en secret.

Si en el futur necessiteu regenerar la clau a causa d'una auditoria periòdica de ciberseguretat, executeu el comand d'aleatorietat criptogràfica segur:

Ventana de terminal
openssl rand -hex 64

Copieu el bloc alfanumèric resultant i actualitzeu immediatament la variable SECRET_KEY_BASE al seu fitxer docker-compose.yml abans del reinici de l'stack.


Per compilar, estructurar i aixecar les dependències de xarxa aïllades i els contenidors de persistència en mode daemon (segon pla):

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

Docker Compose crearà automàticament les xarxes virtuals, muntarà els volums configurats i esperarà que el motor de base de dades MySQL estigui llest per inicialitzar l'estructura SQL de Redmine.


Assegureu la correcta posa en marxa dels serveis mitjançant els comandes tàctics de depuració:

Ventana de terminal
docker compose ps

Criteri d'èxit: Tots dos contenidors (redmine i redmine_db) han de mostrar l'estat Up o healthy.

Per monitoritzar de forma analítica el procés d'inicialització de la base de dades i la migració interna de taules executada per Rails:

Ventana de terminal
docker compose logs -f redmine

Sortida Esperada: Busca al final del flux el registre de sockets actius: Listening on 0.0.0.0:3000 (que és mapejat externament a la porta segura corporativa 5588).


5. Resolució de conflictes comuns (Troubleshooting)

Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»

5.1. El contenidor entra en un bucle de reinicis

Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»
  • Causes freqüents:
    • Mancança de permisos del propietari en els directoris compartits de l'host (omissió de la comanda chown).
    • Errors d'indentació sintàctica en l'arxiu YAML de docker-compose.yml.
  • Solució: Atureu el motor (docker compose down), verifiqueu els logs d'error detallats del socket mitjançant docker compose logs i torneu a executar la correcció de permisos amb chown -R 999:999.

5.2. Error en la connexió de la base de dades

Sección titulada «5.2. Error en la Conexión de la Base de Datos»
  • Causa freqüent:
    • El nom assignat en la variable REDMINE_DB_MYSQL no coincide exactament amb la declaració del nom del servei en l'arxiu Compose.
  • Solució: Obriu l'arxiu d'orquestació i comproveu que ambdós blocs comparteixen l'identificador DNS unificat: redmine_db.

  • ✓ Propietat de fitxers correcta: Tots els directoris muntats configurats amb UID/GID 999 per evitar excepcions d'escriptura.
  • ✓ Secrets de sessió robustos: Variable SECRET_KEY_BASE generada amb OpenSSL i aïllada d'entorns públics.
  • ✓ Sockets de xarxa actius: Mapeig segur a la porta 5588 responent correctament amb redirecció de logs de Rails.
  • ✓ Orquestació Acoplada: Servei d'aplicació principal bloquejat d'inici immediat mitjançant la directiva depends_on fins a la inicialització exitosa de MySQL.