Ir al contenido

DOC-05: Operaties en Onderhoud (Day 2 Operations)

Handleiding voor periodiek onderhoud, automatisering van back-ups zonder blootstelling van inloggegevens en Disaster Recovery-plannen voor de Redmine-infrastructuur.

0lecturas

De veerkracht van een bedrijfsomgeving ligt volledig in het vermogen tot noodherstel. Om een robuuste back-upstrategie te garanderen, implementeren we het principe van datascheiding en de eliminatie van wachtwoorden die in platte tekst worden blootgesteld in de systeemterminals.

[!CAUTION] Risico van blootstelling van referenties: Nooit het MySQL-wachtwoord interactief doorgeven in de terminal (bijv. -p"mi_contraseña"). Door dit te doen, wordt de sleutel in platte tekst vastgelegd in de opdrachtgeschiedenis van bash (~/.bash_history) en in de systeemtabel van processen die zichtbaar is voor elke lokale gebruiker via ps aux.

Om dit beveiligingslek op te lossen, implementeren we een veilig MySQL-clientconfiguratiebestand (.my.cnf) binnen de container of gemonteerd als volume.

Stap 1: Configureer het veilige inloggegevensbestand op de host

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

Maak een optiebestand voor de MySQL-client in de beveiligde configuratiemap van uw server op de host:

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

Voeg de databasebeheerdersgegevens op een gestructureerde manier toe:

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

Stap 2: Pas beperkende machtigingen toe op het bestandssysteem

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

Alleen het serviceaccount voor infrastructuurautomatisering (portel_user) en de Docker-daemon mogen dit bestand lezen:

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

Stap 3: Mapping en Uitvoering in het Compose-bestand

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

Zorg ervoor dat het bestand mysql_backup.cnf wordt gemonteerd in de service redmine_db van het bestand docker-compose.yml in alleen-lezen modus (:ro):

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

Zodra het is gemount, voert u de databasedump uit vanuit uw geplande taakscript (CRON) zonder wachtwoorden te onthullen in de logboeken of in de systeemgeschiedenis:

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

Redmine slaat portaalbijlagen, premium visuele thema's en geïntegreerde plug-ins op in hostmappen. Om hiervan een back-up te maken, maken we een gecomprimeerd bestand met hoge prestaties:

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

In geval van totaal gegevensverlies of corruptie van de fysieke host, volgt u deze stapsgewijze procedure om de operabiliteit op een nieuw knooppunt te herstellen:

  1. Provisioning: Installeer het besturingssysteem en zet de lege infrastructuur op volgens de handleidingen DOC-01, DOC-02 en DOC-03.
  2. Tijdelijke stop: Stop de applicatiecontainer om schrijfinconsistenties te voorkomen terwijl je de gegevens herstelt:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. Herstel van database: Importeer de SQL-dump met behulp van de reeds geconfigureerde veilige verbinding:
    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. Herstel van bestanden: Decompressieer de bestanden en plug-ins in hun respectieve locaties op de host, zorg ervoor dat je de lege persistente directories overschrijft:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. Herconfiguratie van machtigingen: Pas opnieuw de eigendom toe van de geïsoleerde productiegebruiker (999) op het bestandssysteem:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. Volledige start: Initialiseer de applicatie opnieuw:
    Ventana de terminal
    docker compose start redmine

Om de Redmine-instantie te beschermen tegen kwetsbaarheden in het Ruby on Rails-framework en te profiteren van de nieuwste prestatieverbeteringen:

  1. Back-up maken: Maak een handmatige back-up van de database en de bijlagen (sectie 1).
  2. De afbeelding van het register bijwerken: Download de nieuwste tag van de officiële stabiele versie:
    Ventana de terminal
    docker compose pull redmine
  3. Stop en opnieuw maken: Stop en start de stack op de achtergrond. Docker zal de containers opnieuw maken op basis van de nieuwe basisafbeelding:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  4. Migratie van database en plug-ins: Als de versie-upgrade wijzigingen aanbrengt in het relationele databaseschema of in de Redmine-plug-ins, roep dan rechtstreeks de Rake-compilatie-taak aan:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

4. Checklist voor Operationele Validatie (Onderhoud)

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

Implementeer deze wekelijkse checklist om ervoor te zorgen dat het systeem gezond blijft en dat het onderhoudsbeleid strikt wordt nageleefd:

  • ✓ Status van de back-ups: Controleer of de dagelijkse SQL-dumps correct worden gegenereerd in ~/redmine/backups/ en niet de grootte nul hebben.
  • ✓ Eigendomsverificatie (UID 999): Stel vast dat geen enkel bestand dat door gebruikers via het bijlageportaal is geüpload, de machtigingshiërarchie van de lokale server heeft doorbroken.
  • ✓ Opschonen van schijfruimte: Verwijder orphan images en volumes uit de Docker-engine om ruimtegebrek op de virtuele harde schijf van de Proxmox-hypervisor te voorkomen.
  • ✓ Lab-DNS-consistentie: Controleer de correcte interne resolutie van domeinen onder de extensie *.portelcore.com.