Ir al contenido

DOC-03: Bereitstellung, Sicherheit und Inbetriebnahme

Taktisches Verfahren und Best Practices für die Sicherheit bei der Bereitstellung lokaler Berechtigungen, der unveränderlichen Generierung von Secrets und dem kontrollierten Start des Redmine-Stacks.

0Lesungen

1. Berechtigungsverwaltung (Kritischer Schritt unter Linux)

Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»

Im Gegensatz zu anderen Dateisystemen in Testumgebungen erfordern gemountete Volumes innerhalb von Containern in Unternehmens-Linux-Umgebungen eine strikte Zuweisung von Eigentümerschaft und Berechtigungen, um die Sicherheit zu gewährleisten. Der interne Motor von Redmine führt seine Threads unter einem isolierten Systembenutzer mit der ID (UID/GID) 999 aus.

Wenn wir die Eigentümerschaft auf dem Ubuntu-Host ändern, startet die Anwendung, fällt aber sofort aus, wenn sie versucht, angehängte Dateien zu schreiben, benutzerdefinierte Stylesheets zu kompilieren oder Log-Traces zu erstellen, was stille Ausnahmen in der Datenbank zur Folge hat.

Bevor Sie die Infrastruktur initialisieren, führen Sie den Befehl zur Bereinigung der Berechtigungen im Arbeitsverzeichnis im Terminal des Hosts aus:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo chown -R 999:999 files themes plugins mysql_data config

[!WARNING] Zugriffssicherheit: Weisen Sie unter keinen Umständen globale Berechtigungen des Typs chmod -R 777 auf diese Ordner in Unternehmensumgebungen zu. Dies würde schwere Vektoren für Remote-Code-Execution-Angriffe eröffnen, wenn ein Redmine-Plugin Sicherheitslücken aufweist.


2. Unveränderliche Generierung von Geheimnissen (Rails-Sitzungen)

Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»

Redmine speichert die Session-Token verschlüsselt in den Client-Cookies mithilfe des deklarativen Schlüssels SECRET_KEY_BASE. Um Session-Hijacking oder bösartige Interzeption im Browser zu verhindern, muss dieser Schlüssel eine hohe Entropie aufweisen und vollständig unveränderlich und geheim gehalten werden.

Wenn Sie den Schlüssel in Zukunft aufgrund eines regelmäßigen Cybersicherheits-Audits neu generieren müssen, führen Sie den sicheren kryptografischen Zufallsbefehl aus:

Ventana de terminal
openssl rand -hex 64

Kopieren Sie den resultierenden alphanumerischen Block und aktualisieren Sie die Variable SECRET_KEY_BASE in Ihrer Datei docker-compose.yml umgehend vor dem Neustart des Stacks.


Um die isolierten Netzwerkabhängigkeiten und Persistenz-Container im Daemon-Modus (Hintergrund) zu kompilieren, zu strukturieren und zu starten:

Ventana de terminal
cd ~/redmine
docker compose up -d

Docker Compose erstellt automatisch die virtuellen Netzwerke, mountet die konfigurierten Volumes und wartet darauf, dass die MySQL-Datenbank-Engine bereit ist, um die SQL-Struktur von Redmine zu initialisieren.


Stellen Sie die korrekte Inbetriebnahme der Dienste durch die taktischen Debugging-Befehle sicher:

Ventana de terminal
docker compose ps

Erfolgskriterium: Beide Container (redmine und redmine_db) müssen den Status Up oder healthy anzeigen.

Um den Initialisierungsprozess der Datenbank und die von Rails ausgeführte interne Tabellenmigration analytisch zu überwachen:

Ventana de terminal
docker compose logs -f redmine

Erwartete Ausgabe: Suchen Sie am Ende des Protokolls den Eintrag für aktive Sockets: Listening on 0.0.0.0:3000 (der extern auf den sicheren Unternehmensport 5588 abgebildet ist).


5.1. Der Container gerät in eine Neustartschleife

Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»
  • Häufige Ursachen:
    • Fehlende Besitzerberechtigungen in den freigegebenen Host-Verzeichnissen (Auslassen des Befehls chown).
    • Syntax-Einrückungsfehler in der YAML-Datei von docker-compose.yml.
  • Lösung: Stoppen Sie die Engine (docker compose down), überprüfen Sie die detaillierten Socket-Fehlerprotokolle mittels docker compose logs und führen Sie die Berechtigungsreparatur erneut mit chown -R 999:999 aus.
  • Häufige Ursache:
    • Der in der Variable REDMINE_DB_MYSQL zugewiesene Name stimmt nicht exakt mit der Dienstnamendeklaration in der Compose-Datei überein.
  • Lösung: Öffnen Sie die Orchestrierungsdatei und prüfen Sie, ob beide Blöcke die einheitliche DNS-Kennung teilen: redmine_db.

📊 Checkliste für ein erfolgreiches Deployment

Sección titulada «📊 Checklist de Éxito en el Despliegue»
  • ✓ Korrekter Dateibesitz: Alle gemounteten Verzeichnisse sind mit UID/GID 999 konfiguriert, um Schreibfehler zu vermeiden.
  • ✓ Robuste Sitzungsgeheimnisse: Variable SECRET_KEY_BASE wurde mit OpenSSL generiert und ist von öffentlichen Umgebungen isoliert.
  • ✓ Aktive Netzwerksockets: Sichere Abbildung auf Port 5588 mit korrekter Umleitung von Rails-Logs.
  • ✓ Kopplungsorchestrierung: Hauptanwendungsdienst durch Direktive depends_on blockiert, bis MySQL erfolgreich initialisiert ist.