DOC-05: Operacions i manteniment (Day 2 Operations)
Manual de manteniment recurrent, automatització de còpies de seguretat sense exposició de credencials i plans de recuperació de desastres (Disaster Recovery) per a la infraestructura de Redmine.
1. Estratègia de còpies de seguretat (Backups)
Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»La resiliència d'un entorn corporatiu reside enterament en la seva capacitat de recuperació davant de desastres. Per garantir una estratègia de còpies de seguretat robusta, implementem el principi de segregació de dades i l'eliminació de contrasenyes exposades en text clar en les terminals del sistema.
1.1. Còpia de seguretat de base de dades (MySQL Dump segur)
Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»[!CAUTION] Risc d'Exposició de Credencials: Mai passis la contrasenya de MySQL de forma interactiva a la terminal (ex.
-p"mi_contraseña"). En fer-ho, la clau es registrarà en text pla en l'historial de comandes de bash (~/.bash_history) i en la taula de processos del sistema visible per qualsevol usuari local mitjançantps aux.
Per solucionar aquesta bretxa de seguretat, implementem un fitxer de configuració del client MySQL segur (.my.cnf) dins del contèiner o muntat com a volum.
Pas 1: Configurar el fitxer de credencials segur a l'host
Sección titulada «Paso 1: Configurar el archivo de credenciales seguro en el host»Creeu un fitxer d'opcions per al client MySQL dins del directori de configuració protegit del seu servidor a l'host:
mkdir -p ~/redmine/config/secretsnano ~/redmine/config/secrets/mysql_backup.cnfAfegiu les credencials d'administració de la base de dades de manera estructurada:
[client]user=redminepassword=contrasena_secreta_portelcorehost=redmine_dbPas 2: Aplicar permisos restrictius al sistema de fitxers
Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»Només el compte de servei d'automatització d'infraestructures (portel_user) i el daemon de Docker han de poder llegir aquest fitxer:
chmod 600 ~/redmine/config/secrets/mysql_backup.cnfPas 3: Mapeig i execució en el fitxer Compose
Sección titulada «Paso 3: Mapeo y Ejecución en el archivo Compose»Assegureu-vos que el fitxer mysql_backup.cnf està muntat al servei redmine_db del fitxer docker-compose.yml en mode només lectura (:ro):
services: redmine_db: # ... otras configuraciones volumes: - ./config/secrets/mysql_backup.cnf:/etc/mysql/conf.d/mysql_backup.cnf:roUn cop mapejat, executeu el volcat de la base de dades des del seu script de tasques programades (CRON) sense revelar cap contrasenya als logs ni en l'historial del 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. Còpia de seguretat de fitxers (Adjunts i configuracions)
Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»Redmine emmagatzema els adjunts del portal, els temes visuals premium i els plugins integrats en directoris de l'host. Per emmagatzemar-los, creem un fitxer comprimit d'alt rendiment:
# 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. Pla de Recuperació de Desastres (Disaster Recovery)
Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»En cas de pèrdua total de dades o de corrupció de l'host físic, seguiu aquest procediment pas a pas per restaurar l'operativitat en un nou nod:
- Aprovisionament: Instal·leu el sistema operatiu i aixecareu la infraestructura buida seguint les guies DOC-01, DOC-02 i DOC-03.
- Detenció Temporal: Atura el contenidor de l'aplicació per evitar inconsistències d'escriptura mentre restaures les dades:
Ventana de terminal cd ~/redminedocker compose stop redmine - Restauració de Base de Dades: Importa el volcat SQL utilitzant la connexió segura ja configurada:
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 - Restauració d'Arxius: Descomprimeix els arxius i plugins en les seves respectives ubicacions en l'host, assegurant-te de sobrescriure els directoris persistents buits:
Ventana de terminal tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine - Reconfiguració de Permisos: Torna a aplicar la propietat de l'usuari aïllat de producció (
999) al sistema de fitxers:Ventana de terminal sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config - Arranque complet: Inicialitza novament l'aplicació:
Ventana de terminal docker compose start redmine
3. Procediment d'actualització de versions (Updates)
Sección titulada «3. Procedimiento de Actualización de Versiones (Updates)»Per mantenir la instància de Redmine protegida contra vulnerabilitats del framework Ruby on Rails i aprofitar les últimes millores de rendiment:
- Resguardar: Feu una còpia de seguretat manual de la base de dades i dels adjunts (secció 1).
- Actualitzar la Imatge del Registre: Descarrega l'última etiqueta de la versió estable oficial:
Ventana de terminal docker compose pull redmine - Parada i Recreació: Atura i aixeca la pila en segon pla. Docker recrearà els contenidors de forma immutable a partir de la nova imatge base:
Ventana de terminal docker compose downVentana de terminal docker compose up -d - Migració de Base de Dades i Plugins: Si el salt de versió introdueix canvis en l'esquema relacional de la base de dades o en els plugins de Redmine, invoca de forma directa la tasca Rake de compilació:
Ventana de terminal docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production
4. Checklist de validació operacional (manteniment)
Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»Implementeu aquest checklist setmanal per assegurar que el sistema es manté saludable i que les polítiques de manteniment es compleixen de forma rigorosa:
- ✓ Estat de les còpies de seguretat: Comprovar que els volcats SQL diaris es generen correctament a
~/redmine/backups/i no tenen mida zero. - ✓ Verificació de la propietat (
UID 999): Constatar que cap fitxer pujat pels usuaris a través del portal d'adjunts ha trencat la jerarquia de permisos del servidor local. - ✓ Neteja de l'espai en disc: Purgar imatges i volums òrfans del motor Docker per prevenir la falta d'espai al disc dur virtual de l'hipervisor Proxmox.
- ✓ Consistència del DNS del laboratori: Verificar la correcta resolució interna de dominis sota l'extensió
*.portelcore.com.

