Ir al contenido

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.

0lecturas

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:

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

Ventana de terminal
openssl rand -hex 64

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


Para compilar, estructurar y levantar las dependencias de red aisladas y los contenedores de persistencia en modo demonio (segundo plano):

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

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


Asegure la correcta puesta en marcha de los servicios mediante los comandos tácticos de depuración:

Ventana de terminal
docker compose ps

Criterio de Éxito: Ambos contenedores (redmine y redmine_db) deben mostrar el estado Up o healthy.

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:

Ventana de terminal
docker compose logs -f redmine

Salida 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.
  • Solución: Detenga el motor (docker compose down), verifique los logs de error detallados del socket mediante docker compose logs y vuelva a ejecutar la corrección de permisos con chown -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_MYSQL no coincide de forma exacta con la declaración del nombre del servicio en el archivo Compose.
  • Solución: Abre el archivo de orquestación y comprueba que ambos bloques compartan el identificador DNS unificado: redmine_db.

  • ✓ Propiedad de Archivos Correcta: Todos los directorios montados configurados con UID/GID 999 para evitar excepciones de escritura.
  • ✓ Secretos de Sesión Robustos: Variable SECRET_KEY_BASE generada con OpenSSL y aislada de entornos públicos.
  • ✓ Sockets Activos de Red: Mapeo seguro en el puerto 5588 respondiendo correctamente con redirección de logs de Rails.
  • ✓ Orquestación Acoplada: Servicio de aplicación principal bloqueado de inicio inmediato mediante directiva depends_on hasta la inicialización exitosa de MySQL.