Ir al contenido

DOC-03: Despliegue, Seguridad y Puesta en Marcha

Procedimento tático e boas práticas de segurança para o aprovisionamento de permissões locais, geração imutável de segredos e arranque controlado do stack do Redmine.

0lecturas

1. Gestão de Permissões (Passo Crítico no Linux)

Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»

A diferença de outros sistemas de arquivos de entornos de prova, os volumes montados dentro de contenedores em entornos Linux corporativos exigem uma atribuição estricta de propriedade e permissões para garantir a segurança.

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 a infraestrutura, execute o comando de saneamento de permissões a partir do diretório de trabalho no terminal do 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]\r\nSegurança de Acesso: Sob nenhuma circunstância atribua permissões permissivas globais do tipo chmod -R 777 sobre estas pastas em ambientes empresariais. Isso abriria vetores de vulnerabilidade graves para injeção remota de ficheiros se algum plugin do Redmine apresentasse brechas de segurança.


2. Geração Imutável de Segredos (Sessões 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.

Se no futuro você precisar regenerar a chave devido a uma auditoria periódica de segurança cibernética, execute o comando de aleatoriedade 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, estruturar e levantar as dependências de rede isoladas e os contêineres de persistência em modo daemon (segundo plano):

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

O Docker Compose criará automaticamente as redes virtuais, montará os volumes configurados e aguardará que o motor de banco de dados MySQL esteja pronto para inicializar a estrutura SQL do Redmine.


4. Diagnóstico de Estado e Rastreamento de Logs

Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»

Garanta a correta inicialização dos serviços por meio dos comandos táticos de depuração:

Ventana de terminal
docker compose ps

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

Para monitorar de forma analítica o processo de inicialização do banco de dados e a migração interna de tabelas executada pelo Rails:

Ventana de terminal
docker compose logs -f redmine

Saída Esperada: Procure ao final do fluxo o registro de sockets ativos:\r\nListening on 0.0.0.0:3000 (o qual é mapeado externamente à porta segura corporativa 5588).


5. Resolução de Conflitos Comuns (Troubleshooting)

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

5.1. O Contêiner Entra em um Loop de Reinicializações

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

📊 Checklist de Sucesso na Implantação

Sección titulada «📊 Checklist de Éxito en el Despliegue»
  • Propriedade de Arquivos Correta: todos os diretórios montados configurados com UID/GID 999 para evitar exceções de escrita.
  • ✓ 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.