Ir al contenido

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.

0letture

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:

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

Ventana de terminal
openssl rand -hex 64

Copia il blocco alfanumerico risultante e aggiorna immediatamente la variabile SECRET_KEY_BASE nel file docker-compose.yml prima del riavvio dello stack.


Per compilare, strutturare e avviare le dipendenze di rete isolate e i container di persistenza in modalità demone (background):

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

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


Assicurati del corretto avvio dei servizi tramite i comandi tattici di debug:

Ventana de terminal
docker compose ps

Criterio di Successo: Entrambi i container (redmine e redmine_db) devono mostrare lo stato Up o healthy.

Per monitorare in modo analitico il processo di inizializzazione del database e la migrazione interna delle tabelle eseguita da Rails:

Ventana de terminal
docker compose logs -f redmine

Output 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)»
  • 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.
  • Soluzione: Arresta il motore (docker compose down), verifica i log di errore dettagliati del socket tramite docker compose logs ed esegui nuovamente la correzione dei permessi con chown -R 999:999.
  • Causa Frequente:
    • Il nome assegnato nella variabile REDMINE_DB_MYSQL non corrisponde esattamente alla dichiarazione del nome del servizio nel file Compose.
  • Soluzione: Apri il file di orchestrazione e controlla che entrambi i blocchi condividano l'identificatore DNS unificato: redmine_db.

  • ✓ Proprietà dei file corretta: Tutte le directory montate configurate con UID/GID 999 per evitare eccezioni di scrittura.
  • ✓ Segreti di Sessione Robusti: Variabile SECRET_KEY_BASE generata con OpenSSL e isolata da ambienti pubblici.
  • ✓ Sockets Attivi di Rete: Mappatura sicura sulla porta 5588 rispondendo correttamente con reindirizzamento dei log di Rails.
  • ✓ Orquestrazione Accoppiata: Servizio di applicazione principale bloccato dall'avvio immediato tramite direttiva depends_on fino all'inizializzazione riuscita di MySQL.