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.
1. Strategia di Copia di Sicurezza (Backup)
Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»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.
1.1. Backup del Database (MySQL Dump Sicuro)
Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»[!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 tramiteps 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:
mkdir -p ~/redmine/config/secretsnano ~/redmine/config/secrets/mysql_backup.cnfAggiungi le credenziali di amministrazione del database in modo strutturato:
[client]user=redminepassword=contrasena_secreta_portelcorehost=redmine_dbPasso 2: Applicare permessi restrittivi nel file system
Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»Solo l'account di servizio per l'automazione delle infrastrutture (portel_user) e il demone Docker devono poter leggere questo file:
chmod 600 ~/redmine/config/secrets/mysql_backup.cnfPasso 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:roUna 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:
# Ejecución segura mediante el uso del archivo de configuración internodocker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql1.2. Backup dei File (Allegati e Configurazioni)
Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»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:
# Compresión recursiva preservando metadatos y permisos originales de Linuxtar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config2. Piano di Disaster Recovery (Recupero da Disastri)
Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»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:
- Provisionamento: Installare il sistema operativo e creare l'infrastruttura vuota seguendo le guide DOC-01, DOC-02 e DOC-03.
- Fermata Temporanea: Ferma il container dell'applicazione per evitare incoerenze di scrittura mentre ripristini i dati:
Ventana de terminal cd ~/redminedocker compose stop redmine - 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 - 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 - 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 - 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:
- Aggiorna l'Immagine del Registro: Scarica l'ultima etichetta della versione stabile ufficiale:
Ventana de terminal docker compose pull redmine - 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 downVentana de terminal docker compose up -d - 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
4. Checklist di Convalida Operativa (Manutenzione)
Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»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.

