DOC-05: Operacje i konserwacja (Dzień 2 Operacji)
Podręcznik konserwacji cyklicznej, automatyzacji tworzenia kopii zapasowych bez narażenia danych uwierzytelniających i planów odzyskiwania po awarii dla infrastruktury Redmine.
1. Strategia tworzenia kopii zapasowych (Backups)
Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»Odporność środowiska korporacyjnego polega entirely na jego zdolności do odzyskiwania po awarii. Aby zapewnić solidną strategię tworzenia kopii zapasowych, wdrażamy zasadę segregacji danych i eliminacji haseł eksponowanych w czystym tekście na terminalach systemowych.
1.1. Kopia zapasowa bazy danych (bezpieczny MySQL Dump)
Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»[!CAUTION] Ryzko narażenia danych uwierzytelniających: Nigdy nie przekazuj hasła MySQL w sposób interaktywny w terminalu (np.
-p"mi_contraseña"). W ten sposób klucz zostanie zarejestrowany w formacie zwykłego tekstu w historii poleceń basha (~/.bash_history) oraz w tabeli procesów systemowych widocznej dla dowolnego użytkownika lokalnego za pomocąps aux.
Aby rozwiązać tę lukę w zabezpieczeniach, zaimplementowano bezpieczny plik konfiguracyjny klienta MySQL (.my.cnf) wewnątrz kontenera lub zamontowany jako wolumin
Krok 1: Skonfigurować bezpieczny plik poświadczeń na hoście
Sección titulada «Paso 1: Configurar el archivo de credenciales seguro en el host»Utwórz plik opcji dla klienta MySQL w chronionym katalogu konfiguracyjnym serwera na hoście:
mkdir -p ~/redmine/config/secretsnano ~/redmine/config/secrets/mysql_backup.cnfDodaj dane uwierzytelniające do administracji bazą danych w uporządkowany sposób:
[client]user=redminepassword=contrasena_secreta_portelcorehost=redmine_dbKrok 2: Zastosować restrykcyjne uprawnienia w systemie plików
Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»Tylko konto usługi automatyzacji infrastruktury (portel_user) i demon Docker powinny mieć możliwość odczytu tego pliku:
chmod 600 ~/redmine/config/secrets/mysql_backup.cnfKrok 3: Mapowanie i wykonanie w pliku Compose
Sección titulada «Paso 3: Mapeo y Ejecución en el archivo Compose»Upewnij się, że plik mysql_backup.cnf jest zamontowany w usłudze redmine_db pliku docker-compose.yml w trybie tylko do odczytu (:ro):
services: redmine_db: # ... otras configuraciones volumes: - ./config/secrets/mysql_backup.cnf:/etc/mysql/conf.d/mysql_backup.cnf:roPo zmapowaniu wykonaj kopię zapasową bazy danych ze skryptu zadań zaplanowanych (CRON) bez ujawniania żadnych haseł w dziennikach ani w historii systemu:
# 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. Kopia zapasowa plików (załączniki i konfiguracje)
Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»Redmine przechowuje załączniki portalu, premiumowe motywy wizualne i zintegrowane wtyczki w katalogach hosta. Aby je zabezpieczyć, tworzymy archiwum skompresowane o wysokiej wydajności:
# 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. Plan odzyskiwania po awarii (Disaster Recovery)
Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»W przypadku całkowitej utraty danych lub uszkodzenia fizycznego hosta, postępuj zgodnie z tą procedurą krok po kroku, aby przywrócić działanie na nowym węźle:
- Inicjowanie: Zainstaluj system operacyjny i uruchom pustą infrastrukturę, postępując zgodnie z przewodnikami DOC-01, DOC-02 i DOC-03.
- Tymczasowe zatrzymanie: Zatrzymaj kontener aplikacji, aby uniknąć niespójności zapisu podczas przywracania danych:
Ventana de terminal cd ~/redminedocker compose stop redmine - Przywracanie bazy danych: Zaimportuj zrzut SQL, korzystając z bezpiecznego połączenia już skonfigurowanego:
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 - Przywracanie plików: Rozpakuj pliki i wtyczki w odpowiednich lokalizacjach na hoście, upewniając się, że nadpiszesz puste katalogi trwałe:
Ventana de terminal tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine - Rekonfiguracja uprawnień: Ponownie zastosuj własność izolowanego użytkownika produkcyjnego (
999) do systemu plików:Ventana de terminal sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config - Pełny start: Ponownie uruchom aplikację:
Ventana de terminal docker compose start redmine
3. Procedura aktualizacji wersji (aktualizacje)
Sección titulada «3. Procedimiento de Actualización de Versiones (Updates)»Aby utrzymać instancję Redmine chronioną przed lukami w zabezpieczeniach frameworka Ruby on Rails i korzystać z najnowszych ulepszeń wydajności:
- Wykonaj kopię zapasową: Wykonaj ręczną kopię zapasową bazy danych i plików załączników (sekcja 1).
- Zaktualizuj obraz rejestru: Pobierz najnowszą etykietę oficjalnej stabilnej wersji:
Ventana de terminal docker compose pull redmine - Zatrzymanie i ponowne utworzenie: Zatrzymaj i uruchom ponownie stos w tle. Docker ponownie utworzy kontenery w sposób niezmienny na podstawie nowego obrazu podstawowego:
Ventana de terminal docker compose downVentana de terminal docker compose up -d - Migracja bazy danych i wtyczek: Jeśli skok wersji wprowadza zmiany w schemacie relacyjnym bazy danych lub wtyczkach Redmine, wywołaj bezpośrednio zadanie kompilacji Rake:
Ventana de terminal docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production
4. Lista kontrolna walidacji operacyjnej (konserwacja)
Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»Wdróż tę listę kontrolną cotygodniowo, aby upewnić się, że system pozostaje zdrowy i rygorystycznie przestrzega polityk konserwacji:
- ✓ Stan kopii zapasowych: Sprawdź, czy dzienniki SQL są generowane prawidłowo w
~/redmine/backups/i nie mają rozmiaru zero. - ✓ Weryfikacja właściciela (
UID 999): Upewnij się, że żaden plik przesłany przez użytkowników za pośrednictwem portalu załączników nie naruszył hierarchii uprawnień serwera lokalnego. - ✓ Czyszczenie miejsca na dysku: Wyczyść obraz i wolumin Docker, aby zapobiec brakowi miejsca na dysku wirtualnym hipervizora Proxmox.
- ✓ Spójność DNS laboratorium: Sprawdź prawidłową rozdzielczość wewnętrzną domen pod rozszerzeniem
*.portelcore.com.

