DOC-03: Deployment, Sicurezza e Messa in Produzione
Procedura tattica e buone pratiche di sicurezza per il provisioning di permessi locali, generazione immutabile di segreti e avvio controllato dello stack Redmine.
1. Gestione dei Permessi (Passaggio Critico in Linux)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»A differenza di altri file system in ambienti di test, i volumi montati all'interno di container in ambienti Linux aziendali richiedono un'assegnazione rigorosa di proprietà e permessi per garantire la sicurezza. Il motore interno di Redmine esegue i suoi thread sotto un utente di sistema isolato con l'identificativo (UID/GID) 999.
Se omettiamo il cambio di proprietà sull'host Ubuntu, l'applicazione si avvierà, ma fallirà immediatamente nel tentativo di scrivere allegati, compilare fogli di stile personalizzati o generare log dump, causando eccezioni silenziose nel database.
Prima di inizializzare l'infrastruttura, esegui il comando di sanificazione dei permessi dalla directory di lavoro nel terminale dell'host:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] Sicurezza di Accesso: In nessun caso assegnare permessi permissivi globali del tipo
chmod -R 777su queste cartelle in ambienti aziendali. Ciò aprirebbe vettori di vulnerabilità gravi per iniezione remota di file se qualche plugin di Redmine presentasse falle di sicurezza.
2. Generazione Immutabile di Segreti (Sessioni Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine memorizza i token di sessione in modo cifrato nei cookie del client tramite la chiave dichiarativa SECRET_KEY_BASE. Per evitare il session hijacking o l'intercettazione malevola nel browser, questa chiave deve avere un'alta entropia e deve essere mantenuta completamente immutabile e segreta.
Se in futuro dovessi rigenerare la chiave a causa di un audit periodico di sicurezza informatica, esegui il comando di casualità crittografica sicura:
openssl rand -hex 64Copia il blocco alfanumerico risultante e aggiorna immediatamente la variabile SECRET_KEY_BASE nel file docker-compose.yml prima del riavvio dello stack.
3. Avvio dello Stack
Sección titulada «3. Puesta en Marcha del Stack»Per compilare, strutturare e avviare le dipendenze di rete isolate e i container di persistenza in modalità demone (background):
cd ~/redminedocker compose up -dDocker Compose creerà automaticamente le reti virtuali, monterà i volumi configurati e attenderà che il motore del database MySQL sia pronto per inizializzare la struttura SQL di Redmine.
4. Diagnostica di Stato e Tracce dei Log
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Assicurati del corretto avvio dei servizi tramite i comandi tattici di debug:
4.1. Verifica dei Container Attivi
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psCriterio di Successo: Entrambi i container (redmine e redmine_db) devono mostrare lo stato Up o healthy.
4.2. Audit delle Tracce in Tempo Reale
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Per monitorare in modo analitico il processo di inizializzazione del database e la migrazione interna delle tabelle eseguita da Rails:
docker compose logs -f redmineOutput Atteso: Cercare alla fine del flusso il registro dei socket attivi:
Listening on 0.0.0.0:3000 (che è mappato esternamente alla porta sicura aziendale 5588).
5. Risoluzione dei Conflitti Comuni (Troubleshooting)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. Il Container Entra in un Loop di Riavvi
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- Cause Frequenti:
- Mancanza di permessi del proprietario nelle directory condivise dell'host (omissione del comando
chown). - Errori di indentazione sintattica nel file YAML di
docker-compose.yml.
- Mancanza di permessi del proprietario nelle directory condivise dell'host (omissione del comando
- Soluzione: Arresta il motore (
docker compose down), verifica i log di errore dettagliati del socket tramitedocker compose logsed esegui nuovamente la correzione dei permessi conchown -R 999:999.
5.2. Errore di Connessione al Database
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Causa Frequente:
- Il nome assegnato nella variabile
REDMINE_DB_MYSQLnon corrisponde esattamente alla dichiarazione del nome del servizio nel file Compose.
- Il nome assegnato nella variabile
- Soluzione: Apri il file di orchestrazione e controlla che entrambi i blocchi condividano l'identificatore DNS unificato:
redmine_db.
📊 Checklist di Successo del Deployment
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Proprietà dei file corretta: Tutte le directory montate configurate con UID/GID
999per evitare eccezioni di scrittura. - ✓ Segreti di Sessione Robusti: Variabile
SECRET_KEY_BASEgenerata con OpenSSL e isolata da ambienti pubblici. - ✓ Sockets Attivi di Rete: Mappatura sicura sulla porta
5588rispondendo correttamente con reindirizzamento dei log di Rails. - ✓ Orquestrazione Accoppiata: Servizio di applicazione principale bloccato dall'avvio immediato tramite direttiva
depends_onfino all'inizializzazione riuscita di MySQL.

