Ir al contenido

DOC-05: Operaciones y Mantenimiento (Day 2 Operations)

Manual de mantenimiento recurrente, automatización de copias de seguridad sin exposición de credenciales y planes de Disaster Recovery para la infraestructura de Redmine.

0lecturas

1. Estrategia de Copias de Seguridad (Backups)

Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»

La resiliencia de un entorno corporativo reside enteramente en su capacidad de recuperación ante desastres. Para garantizar una estrategia de copias de seguridad robusta, implementamos el principio de segregación de datos y la eliminación de contraseñas expuestas en texto claro en las terminales del sistema.

1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)

Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»

[!CAUTION] Riesgo de Exposición de Credenciales: Nunca pases la contraseña de MySQL de forma interactiva en la terminal (ej. -p"mi_contraseña"). Al hacerlo, la clave se registrará en texto plano en el historial de comandos de bash (~/.bash_history) y en la tabla de procesos del sistema visible por cualquier usuario local mediante ps aux.

Para solucionar esta brecha de seguridad, implementamos un archivo de configuración del cliente MySQL seguro (.my.cnf) dentro del contenedor o montado como volumen.

Paso 1: Configurar el archivo de credenciales seguro en el host

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

Cree un archivo de opciones para el cliente MySQL dentro del directorio de configuración protegido de su servidor en el host:

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

Agregue las credenciales de administración de la base de datos de manera estructurada:

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

Paso 2: Aplicar permisos restrictivos en el sistema de archivos

Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»

Solo la cuenta de servicio de automatización de infraestructuras (portel_user) y el demonio de Docker deben poder leer este archivo:

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

Paso 3: Mapeo y Ejecución en el archivo Compose

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

Asegúrese de que el archivo mysql_backup.cnf está montado en el servicio redmine_db del archivo docker-compose.yml en modo solo lectura (:ro):

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

Una vez mapeado, ejecute el volcado de base de datos desde su script de tareas programadas (CRON) sin revelar ninguna contraseña en los logs ni en el 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. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)

Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»

Redmine almacena los adjuntos del portal, los temas visuales premium y los plugins integrados en directorios del host. Para respaldarlos, creamos un archivo comprimido de alto rendimiento:

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. Plan de Recuperación ante Desastres (Disaster Recovery)

Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»

En caso de pérdida total de datos o de corrupción del host físico, siga este procedimiento paso a paso para restaurar la operatividad en un nuevo nodo:

  1. Aprovisionamiento: Instale el sistema operativo y levante la infraestructura vacía siguiendo las guías DOC-01, DOC-02 y DOC-03.
  2. Detención Temporal: Detenga el contenedor de la aplicación para evitar inconsistencias de escritura mientras restaura los datos:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. Restauración de Base de Datos: Importe el volcado SQL utilizando la conexión segura ya 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ón de Archivos: Descomprima los archivos y plugins en sus respectivas ubicaciones en el host, asegurándose de sobrescribir los directorios persistentes vacíos:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. Reconfiguración de Permisos: Vuelva a aplicar la propiedad del usuario aislado de producción (999) al sistema de ficheros:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. Arranque Completo: Inicialice nuevamente la aplicación:
    Ventana de terminal
    docker compose start redmine

3. Procedimiento de Actualización de Versiones (Updates)

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

Para mantener la instancia de Redmine protegida frente a vulnerabilidades del framework Ruby on Rails y aprovechar las últimas mejoras de rendimiento:

  1. Respaldar: Realice una copia de seguridad manual de la base de datos y los archivos adjuntos (sección 1).
  2. Actualizar la Imagen del Registro: Descargue la última etiqueta de la versión estable oficial:
    Ventana de terminal
    docker compose pull redmine
  3. Parada y Recreación: Detenga y levante el stack en segundo plano. Docker recreará los contenedores de forma inmutable a partir de la nueva imagen base:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  4. Migración de Base de Datos y Plugins: Si el salto de versión introduce cambios en el esquema relacional de la base de datos o en los plugins de Redmine, invoque de forma directa la tarea Rake de compilación:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

4. Checklist de Validación Operacional (Mantenimiento)

Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»

Implemente este checklist semanal para asegurar que el sistema se mantiene saludable y que las políticas de mantenimiento se cumplen de forma rigurosa:

  • ✓ Estado de las Copias de Seguridad: Comprobar que los volcados SQL diarios se generan correctamente en ~/redmine/backups/ y no tienen tamaño cero.
  • ✓ Verificación del Propietario (UID 999): Constatar que ningún archivo subido por los usuarios a través del portal de adjuntos ha roto la jerarquía de permisos del servidor local.
  • ✓ Saneamiento del Espacio en Disco: Purgar imágenes y volúmenes huérfanos del motor Docker para prevenir falta de espacio en el disco duro virtual del hipervisor Proxmox.
  • ✓ Consistencia de DNS de Laboratorio: Verificar la correcta resolución interna de dominios bajo la extensión *.portelcore.com.