Ir al contenido

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.

0lectures

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çant ps 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:

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

Afegiu les credencials d'administració de la base de dades de manera estructurada:

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

Pas 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:

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

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:ro

Un 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:

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

1.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:

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

2. 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:

  1. Aprovisionament: Instal·leu el sistema operatiu i aixecareu la infraestructura buida seguint les guies DOC-01, DOC-02 i DOC-03.
  2. Detenció Temporal: Atura el contenidor de l'aplicació per evitar inconsistències d'escriptura mentre restaures les dades:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. 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
  4. 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
  5. 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
  6. 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:

  1. Resguardar: Feu una còpia de seguretat manual de la base de dades i dels adjunts (secció 1).
  2. Actualitzar la Imatge del Registre: Descarrega l'última etiqueta de la versió estable oficial:
    Ventana de terminal
    docker compose pull redmine
  3. 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 down
    Ventana de terminal
    docker compose up -d
  4. 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.