DOC-03: Despliegue, Seguridad y Puesta en Marcha
Procedimiento táctico y buenas prácticas de seguridad para el aprovisionamiento de permisos locales, generación inmutable de secretos y arranque controlado del stack de Redmine.
1. Gestión de Permisos (Paso Crítico en Linux)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»A diferencia de otros sistemas de archivos de entornos de prueba, los volúmenes montados dentro de contenedores en entornos Linux corporativos exigen una asignación estricta de propiedad y permisos para garantizar la seguridad. El motor interno de Redmine ejecuta sus hilos bajo un usuario del sistema aislado con el identificador (UID/GID) 999.
Si omitimos el cambio de propietario en el host de Ubuntu, la aplicación arrancará, pero fallará inmediatamente al intentar escribir archivos adjuntos, compilar hojas de estilo personalizadas o volcar trazas de logs, provocando excepciones silenciosas en base de datos.
Antes de inicializar la infraestructura, ejecuta el comando de saneamiento de permisos desde el directorio de trabajo en la terminal del host:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] 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. Generación Inmutable de Secretos (Sesiones Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine almacena los tokens de sesión de manera cifrada en las cookies del cliente mediante la clave declarativa SECRET_KEY_BASE. Para evitar el secuestro de sesiones o la interceptación maliciosa en el navegador, esta llave debe ser de alta entropía y mantenerse completamente inmutable y en secreto.
Si en el futuro requieres regenerar la clave debido a una auditoría periódica de ciberseguridad, ejecuta el comando de aleatoriedad criptográfica seguro:
openssl rand -hex 64Copie el bloque alfanumérico resultante y actualice de forma inmediata la variable SECRET_KEY_BASE en su archivo docker-compose.yml antes del reinicio del stack.
3. Puesta en Marcha del Stack
Sección titulada «3. Puesta en Marcha del Stack»Para compilar, estructurar y levantar las dependencias de red aisladas y los contenedores de persistencia en modo demonio (segundo plano):
cd ~/redminedocker compose up -dDocker Compose creará automáticamente las redes virtuales, montará los volúmenes configurados y esperará que el motor de base de datos MySQL esté listo para inicializar la estructura SQL de Redmine.
4. Diagnóstico de Estado y Trazas de Logs
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Asegure la correcta puesta en marcha de los servicios mediante los comandos tácticos de depuración:
4.1. Verificación de Contenedores Activos
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psCriterio de Éxito: Ambos contenedores (redmine y redmine_db) deben mostrar el estado Up o healthy.
4.2. Auditoría de Trazas en Tiempo Real
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Para monitorizar de forma analítica el proceso de inicialización de la base de datos y la migración interna de tablas ejecutada por Rails:
docker compose logs -f redmineSalida Esperada: Busca al final del flujo el registro de sockets activos:
Listening on 0.0.0.0:3000 (el cual es mapeado externamente al puerto seguro corporativo 5588).
5. Resolución de Conflictos Comunes (Troubleshooting)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. El Contenedor Entra en un Loop de Reinicios
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- Causas Frecuentes:
- Falta de permisos del propietario en los directorios compartidos del host (omisión del comando
chown). - Errores de indentación sintáctica en el archivo YAML de
docker-compose.yml.
- Falta de permisos del propietario en los directorios compartidos del host (omisión del comando
- Solución: Detenga el motor (
docker compose down), verifique los logs de error detallados del socket mediantedocker compose logsy vuelva a ejecutar la corrección de permisos conchown -R 999:999.
5.2. Error en la Conexión de la Base de Datos
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Causa Frecuente:
- El nombre asignado en la variable
REDMINE_DB_MYSQLno coincide de forma exacta con la declaración del nombre del servicio en el archivo Compose.
- El nombre asignado en la variable
- Solución: Abre el archivo de orquestación y comprueba que ambos bloques compartan el identificador DNS unificado:
redmine_db.
📊 Checklist de Éxito en el Despliegue
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Propiedad de Archivos Correcta: Todos los directorios montados configurados con UID/GID
999para evitar excepciones de escritura. - ✓ Secretos de Sesión Robustos: Variable
SECRET_KEY_BASEgenerada con OpenSSL y aislada de entornos públicos. - ✓ Sockets Activos de Red: Mapeo seguro en el puerto
5588respondiendo correctamente con redirección de logs de Rails. - ✓ Orquestación Acoplada: Servicio de aplicación principal bloqueado de inicio inmediato mediante directiva
depends_onhasta la inicialización exitosa de MySQL.

