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.
1. Backup-Strategie (Backups)
Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»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.
1.1. Datenbank-Backup (Sicherer MySQL-Dump)
Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»[!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 überps auxsichtbar 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:
mkdir -p ~/redmine/config/secretsnano ~/redmine/config/secrets/mysql_backup.cnfFügen Sie die Anmeldeinformationen für die Datenbankverwaltung strukturiert hinzu:
[client]user=redminepassword=contrasena_secreta_portelcorehost=redmine_dbSchritt 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:
chmod 600 ~/redmine/config/secrets/mysql_backup.cnfSchritt 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:roFü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:
# Ejecución segura mediante el uso del archivo de configuración internodocker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql1.2. Datei-Backup (Anhänge und Konfigurationen)
Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»Redmine speichert Portalanhänge, Premium-Visual-Themes und integrierte Plugins in Host-Verzeichnissen. Um diese zu sichern, erstellen wir ein hochleistungsfähiges komprimiertes Archiv:
# Compresión recursiva preservando metadatos y permisos originales de Linuxtar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config2. Notfallwiederherstellungsplan (Disaster Recovery)
Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»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:
- Bereitstellung: Installieren Sie das Betriebssystem und bauen Sie die leere Infrastruktur gemäß den Leitfäden DOC-01, DOC-02 und DOC-03 auf.
- Vorübergehende Anhaltung: Stoppen Sie den Anwendungscontainer, um Schreibinkonsistenzen während der Datenwiederherstellung zu vermeiden:
Ventana de terminal cd ~/redminedocker compose stop redmine - 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 - 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 - 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 - Vollständiger Start: Initialisieren Sie die Anwendung erneut:
Ventana de terminal docker compose start redmine
3. Verfahren zur Versionsaktualisierung (Updates)
Sección titulada «3. Procedimiento de Actualización de Versiones (Updates)»Um die Redmine-Instanz vor Schwachstellen im Ruby on Rails-Framework zu schützen und die neuesten Leistungsverbesserungen zu nutzen:
- Backup: Führen Sie eine manuelle Sicherung der Datenbank und der Anhänge durch (Abschnitt 1).
- Update der Registrierungsabbildung: Laden Sie das neueste Label der offiziellen stabilen Version herunter:
Ventana de terminal docker compose pull redmine - 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 downVentana de terminal docker compose up -d - 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
4. Checkliste zur operativen Validierung (Wartung)
Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»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.

