Ir al contenido

DOC-05: Betrieb und Wartung (Day 2 Operations)

Handbuch für wiederkehrende Wartung, Automatisierung von Backups ohne Preisgabe von Anmeldedaten und Disaster-Recovery-Pläne für die Redmine-Infrastruktur.

0Lesungen

Die Ausfallsicherheit einer Unternehmensumgebung hängt vollständig von ihrer Fähigkeit zur Notfallwiederherstellung ab. Um eine robuste Backup-Strategie zu gewährleisten, implementieren wir das Prinzip der Datentrennung und die Beseitigung von im Klartext offengelegten Passwörtern in den Systemterminals.

[!CAUTION] Risiko der Offenlegung von Anmeldeinformationen: Geben Sie niemals das MySQL-Passwort interaktiv in der Terminal (z. B. -p"mi_contraseña"). Wenn Sie dies tun, wird der Schlüssel im Klartext im Bash-Befehlsverlauf (~/.bash_history) und in der Systemprozessliste, die von jedem lokalen Benutzer über ps aux sichtbar ist, gespeichert.

Um diese Sicherheitslücke zu schließen, haben wir eine sichere MySQL-Client-Konfigurationsdatei (.my.cnf) innerhalb des Containers implementiert oder als Volume gemountet.

Schritt 1: Konfigurieren der sicheren Anmeldeinformationsdatei auf dem Host

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

Erstellen Sie eine Optionsdatei für den MySQL-Client im geschützten Konfigurationsverzeichnis Ihres Servers auf dem Host:

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

Fügen Sie die Anmeldeinformationen für die Datenbankverwaltung strukturiert hinzu:

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

Schritt 2: Anwenden restriktiver Berechtigungen im Dateisystem

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

Nur das Servicekonto der Infrastrukturautomatisierung (portel_user) und der Docker-Daemon dürfen diese Datei lesen:

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

Schritt 3: Mapping und Ausführung in der Compose-Datei

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

Stellen Sie sicher, dass die Datei mysql_backup.cnf im Dienst redmine_db der Datei docker-compose.yml im Nur-Lese-Modus (:ro) gemountet ist:

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

Führen Sie nach dem Mapping den Datenbank-Dump aus Ihrem Skript für geplante Aufgaben (CRON) aus, ohne Passwörter in den Protokollen oder im Systemverlauf preiszugeben:

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 speichert Portalanhänge, Premium-Visual-Themes und integrierte Plugins in Host-Verzeichnissen. Um diese zu sichern, erstellen wir ein hochleistungsfähiges komprimiertes Archiv:

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

Im Falle eines vollständigen Datenverlusts oder einer Beschädigung des physischen Hosts befolgen Sie dieses schrittweise Verfahren, um die Betriebsbereitschaft auf einem neuen Knoten wiederherzustellen:

  1. Bereitstellung: Installieren Sie das Betriebssystem und bauen Sie die leere Infrastruktur gemäß den Leitfäden DOC-01, DOC-02 und DOC-03 auf.
  2. Vorübergehende Anhaltung: Stoppen Sie den Anwendungscontainer, um Schreibinkonsistenzen während der Datenwiederherstellung zu vermeiden:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. Datenbankwiederherstellung: Importieren Sie die SQL-Sicherung mithilfe der bereits konfigurierten sicheren Verbindung:
    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. Dateiwiederherstellung: Dekomprimieren Sie die Dateien und Plugins in ihren jeweiligen Speicherorten auf dem Host und stellen Sie sicher, dass die leeren, persistenten Verzeichnisse überschrieben werden:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. Neukonfiguration von Berechtigungen: Stellen Sie die Eigentümerschaft des isolierten Produktionsbenutzers (999) für das Dateisystem wieder her:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. Vollständiger Start: Initialisieren Sie die Anwendung erneut:
    Ventana de terminal
    docker compose start redmine

Um die Redmine-Instanz vor Schwachstellen im Ruby on Rails-Framework zu schützen und die neuesten Leistungsverbesserungen zu nutzen:

  1. Backup: Führen Sie eine manuelle Sicherung der Datenbank und der Anhänge durch (Abschnitt 1).
  2. Update der Registrierungsabbildung: Laden Sie das neueste Label der offiziellen stabilen Version herunter:
    Ventana de terminal
    docker compose pull redmine
  3. Stoppen und Neuerstellung: Stoppen und heben Sie den Stapel im Hintergrund. Docker erstellt die Container unveränderlich aus dem neuen Basisimage neu:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  4. Datenbank- und Plugin-Migration: Wenn der Versionsprung Änderungen an der relationalen Datenbankstruktur oder an Redmine-Plugins einführt, rufen Sie direkt die Rake-Build-Aufgabe auf:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

Implementieren Sie diese wöchentliche Checkliste, um sicherzustellen, dass das System fehlerfrei bleibt und die Wartungsrichtlinien strikt eingehalten werden:

  • ✓ Status der Sicherungskopien: Überprüfen Sie, ob die täglichen SQL-Dumps korrekt in ~/redmine/backups/ erstellt werden und nicht die Größe Null haben.
  • ✓ Überprüfung des Eigentümers (UID 999): Bestätigen Sie, dass keine von Benutzern hochgeladenen Dateien über das Anhangsportal die lokale Serverberechtigungshierarchie gebrochen haben.
  • ✓ Platzbereinigung: Löschen Sie verwaiste Docker-Images und -Volumes, um Platzmangel auf der virtuellen Festplatte des Proxmox-Hypervisors zu verhindern.
  • ✓ Konsistenz des Labor-DNS: Überprüfen Sie die korrekte interne Auflösung von Domänen unter der Erweiterung *.portelcore.com.