Ir al contenido

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

Manual de manutenção recorrente, automação de cópias de segurança sem exposição de credenciais e planos de Disaster Recovery para a infraestrutura do Redmine.

0lecturas

1. Estratégia de Cópias de Segurança (Backups)

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

A resiliência de um ambiente corporativo reside inteiramente em sua capacidade de recuperação de desastres. Para garantir uma estratégia de cópias de segurança robusta, implementamos o princípio de segregação de dados e a eliminação de senhas expostas em texto claro nos terminais do sistema.

1.1. Cópia de Segurança de Banco de Dados (MySQL Dump Seguro)

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

[!CAUTION]\r\nRisco de Exposição de Credenciais: Nunca passe a senha do MySQL de forma interativa no terminal (por exemplo, -p"mi_contraseña"). Ao fazer isso, a chave será registrada em texto plano no histórico de comandos do bash (~/.bash_history) e na tabela de processos do sistema visível por qualquer usuário local por meio de 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.

Passo 1: Configurar o arquivo de credenciais seguro no host

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

Crie um arquivo de opções para o cliente MySQL dentro do diretório de configuração protegido do seu servidor no host:

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

Adicione as credenciais de administração do banco de dados de maneira estruturada:

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

Passo 2: Aplicar permissões restritivas no sistema de arquivos

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

Apenas a conta de serviço de automação de infraestruturas (portel_user) e o demonio de Docker devem poder ler esse arquivo.

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

Passo 3: Mapeamento e Execução no arquivo Compose

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

Asegure-se de que o arquivo mysql_backup.cnf esteja montado no serviço redmine_db do arquivo docker-compose.yml em modo somente leitura (:ro):

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

Uma vez mapeado, execute o dump do banco de dados a partir do seu script de tarefas agendadas (CRON) sem revelar nenhuma senha nos logs ou no histórico do 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 Segurança de Arquivos (Anexos e Configurações)

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

O Redmine armazena os anexos do portal, os temas visuais premium e os plugins integrados em diretórios do host. Para fazer o backup deles, criamos um arquivo compactado de alto desempenho:

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. Plano de Recuperação de Desastres (Disaster Recovery)

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

Em caso de perda total de dados ou de corrupção do host físico, siga este procedimento passo a passo para restaurar a operacionalidade em um novo nó:

  1. Aprovisionamento: instale o sistema operacional e levante a infraestrutura vazia seguindo as guias DOC-01, DOC-02 e 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. Procedimento de Atualização de Versões (Updates)

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

Para manter a instância do Redmine protegida contra vulnerabilidades do framework Ruby on Rails e aproveitar as últimas melhorias de desempenho:

  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 Validação Operacional (Manutenção)

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

Implemente este checklist semanal para garantir que o sistema se mantenha saudável e que as políticas de manutenção sejam cumpridas de forma rigorosa:

  • 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.