Ir al contenido

DOC-05: Operazioni e Manutenzione (Day 2 Operations)

Manuale di manutenzione ricorrente, automazione dei backup senza esposizione di credenziali e piani di Disaster Recovery per l'infrastruttura Redmine.

0letture

La resilienza di un ambiente aziendale risiede interamente nella sua capacità di disaster recovery. Per garantire una solida strategia di backup, implementiamo il principio di segregazione dei dati e l'eliminazione delle password esposte in chiaro nei terminali di sistema.

[!CAUTION] Rischio di Esposizione di Credenziali: Non passare mai la password di MySQL in modo interattivo nel terminale (ad es. -p"mi_contraseña"). Facendolo, la chiave verrà registrata in chiaro nella cronologia dei comandi di bash (~/.bash_history) e nella tabella dei processi del sistema visibile a qualsiasi utente locale tramite ps aux.

Per risolvere questa falla di sicurezza, abbiamo implementato un file di configurazione sicuro del client MySQL (.my.cnf) all'interno del container o montato come volume.

Passo 1: Configurare il file delle credenziali sicuro sull'host

Sección titulada «Paso 1: Configurar el archivo de credenciales seguro en el host»

Crea un file di opzioni per il client MySQL all'interno della directory di configurazione protetta del tuo server sull'host:

Ventana de terminal
mkdir -p ~/redmine/config/secrets
nano ~/redmine/config/secrets/mysql_backup.cnf

Aggiungi le credenziali di amministrazione del database in modo strutturato:

[client]
user=redmine
password=contrasena_secreta_portelcore
host=redmine_db

Solo l'account di servizio per l'automazione delle infrastrutture (portel_user) e il demone Docker devono poter leggere questo file:

Ventana de terminal
chmod 600 ~/redmine/config/secrets/mysql_backup.cnf

Passo 3: Mappatura ed Esecuzione nel file Compose

Sección titulada «Paso 3: Mapeo y Ejecución en el archivo Compose»

Assicurati che il file mysql_backup.cnf sia montato nel servizio redmine_db del file docker-compose.yml in modalità sola lettura (:ro):

services:
redmine_db:
# ... otras configuraciones
volumes:
- ./config/secrets/mysql_backup.cnf:/etc/mysql/conf.d/mysql_backup.cnf:ro

Una volta mappato, esegui il dump del database dal tuo script di operazioni pianificate (CRON) senza rivelare alcuna password nei log o nella cronologia di sistema:

Ventana de terminal
# Ejecución segura mediante el uso del archivo de configuración interno
docker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql

Redmine archivia gli allegati del portale, i temi visivi premium e i plugin integrati nelle directory dell'host. Per eseguirne il backup, creiamo un file compresso ad alte prestazioni:

Ventana de terminal
# Compresión recursiva preservando metadatos y permisos originales de Linux
tar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config

In caso di perdita totale dei dati o di corruzione dell'host fisico, segui questa procedura passo passo per ripristinare l'operatività su un nuovo nodo:

  1. Provisionamento: Installare il sistema operativo e creare l'infrastruttura vuota seguendo le guide DOC-01, DOC-02 e DOC-03.
  2. Fermata Temporanea: Ferma il container dell'applicazione per evitare incoerenze di scrittura mentre ripristini i dati:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. Restaurazione del Database: Importa il dump SQL utilizzando la connessione sicura già configurata:
    Ventana de terminal
    docker exec -i redmine_db mysql --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine < ~/redmine/backups/redmine_backup_2026-05-22.sql
  4. Restaurazione dei File: Decomprimi i file e i plugin nelle loro rispettive posizioni sull'host, assicurandoti di sovrascrivere le directory persistenti vuote:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. Riconfigurazione dei Permessi: Riapplica la proprietà dell'utente isolato di produzione (999) al sistema di file:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. Avvio Completo: Inizializza nuovamente l'applicazione:
    Ventana de terminal
    docker compose start redmine

3. Procedura di Aggiornamento delle Versioni (Update)

Sección titulada «3. Procedimiento de Actualización de Versiones (Updates)»

Per mantenere l'istanza di Redmine protetta dalle vulnerabilità del framework Ruby on Rails e sfruttare gli ultimi miglioramenti delle prestazioni:

  1. Aggiorna l'Immagine del Registro: Scarica l'ultima etichetta della versione stabile ufficiale:
    Ventana de terminal
    docker compose pull redmine
  2. Fermata e Ricreazione: Ferma e solleva lo stack in secondo piano. Docker ricreerà i contenitori in modo immutabile a partire dalla nuova immagine base:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  3. Migrazione del Database e dei Plugin: Se il salto di versione introduce modifiche nello schema relazionale del database o nei plugin di Redmine, invoca direttamente la task Rake di compilazione:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

Implementa questa checklist settimanale per assicurarti che il sistema rimanga in salute e che le policy di manutenzione vengano rispettate rigorosamente:

  • ✓ Stato dei backup: Verificare che i dump SQL giornalieri vengano generati correttamente in ~/redmine/backups/ e non abbiano dimensione zero.
  • ✓ Verifica del proprietario (UID 999): Accertarsi che nessun file caricato dagli utenti tramite il portale degli allegati abbia violato la gerarchia dei permessi del server locale.
  • ✓ Pulizia dello spazio su disco: Eliminare immagini e volumi orfani dal motore Docker per prevenire la mancanza di spazio sul disco rigido virtual dell'hypervisor Proxmox.
  • ✓ Coerenza DNS del laboratorio: Verificare la corretta risoluzione interna dei domini sotto l'estensione *.portelcore.com.