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.
1. Gestió de permisos (Pas crític en Linux)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»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:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo 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 777sobre 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:
openssl rand -hex 64Copieu 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.
3. Posa en marxa de l'stack
Sección titulada «3. Puesta en Marcha del Stack»Per compilar, estructurar i aixecar les dependències de xarxa aïllades i els contenidors de persistència en mode daemon (segon pla):
cd ~/redminedocker compose up -dDocker 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.
4. Diagnòstic d'estat i traces de logs
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Assegureu la correcta posa en marxa dels serveis mitjançant els comandes tàctics de depuració:
4.1. Verificació de contenidors actius
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psCriteri d'èxit: Tots dos contenidors (redmine i redmine_db) han de mostrar l'estat Up o healthy.
4.2. Auditoria de traces en temps real
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»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:
docker compose logs -f redmineSortida 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.
- Mancança de permisos del propietari en els directoris compartits de l'host (omissió de la comanda
- Solució: Atureu el motor (
docker compose down), verifiqueu els logs d'error detallats del socket mitjançantdocker compose logsi torneu a executar la correcció de permisos ambchown -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_MYSQLno coincide exactament amb la declaració del nom del servei en l'arxiu Compose.
- El nom assignat en la variable
- Solució: Obriu l'arxiu d'orquestació i comproveu que ambdós blocs comparteixen l'identificador DNS unificat:
redmine_db.
📊 Checklist d'èxit en el desplegament
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Propietat de fitxers correcta: Tots els directoris muntats configurats amb UID/GID
999per evitar excepcions d'escriptura. - ✓ Secrets de sessió robustos: Variable
SECRET_KEY_BASEgenerada amb OpenSSL i aïllada d'entorns públics. - ✓ Sockets de xarxa actius: Mapeig segur a la porta
5588responent correctament amb redirecció de logs de Rails. - ✓ Orquestació Acoplada: Servei d'aplicació principal bloquejat d'inici immediat mitjançant la directiva
depends_onfins a la inicialització exitosa de MySQL.

