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.
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:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] Zugriffssicherheit: Weisen Sie unter keinen Umständen globale Berechtigungen des Typs
chmod -R 777auf 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:
openssl rand -hex 64Kopieren 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.
3. Inbetriebnahme des Stacks
Sección titulada «3. Puesta en Marcha del Stack»Um die isolierten Netzwerkabhängigkeiten und Persistenz-Container im Daemon-Modus (Hintergrund) zu kompilieren, zu strukturieren und zu starten:
cd ~/redminedocker compose up -dDocker 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.
4. Zustandsdiagnose und Log-Traces
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Stellen Sie die korrekte Inbetriebnahme der Dienste durch die taktischen Debugging-Befehle sicher:
4.1. Überprüfung aktiver Container
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psErfolgskriterium: Beide Container (redmine und redmine_db) müssen den Status Up oder healthy anzeigen.
4.2. Echtzeit-Audit von Traces
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Um den Initialisierungsprozess der Datenbank und die von Rails ausgeführte interne Tabellenmigration analytisch zu überwachen:
docker compose logs -f redmineErwartete 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. Lösung häufiger Konflikte (Fehlerbehebung)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»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.
- Fehlende Besitzerberechtigungen in den freigegebenen Host-Verzeichnissen (Auslassen des Befehls
- Lösung: Stoppen Sie die Engine (
docker compose down), überprüfen Sie die detaillierten Socket-Fehlerprotokolle mittelsdocker compose logsund führen Sie die Berechtigungsreparatur erneut mitchown -R 999:999aus.
5.2. Fehler bei der Datenbankverbindung
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Häufige Ursache:
- Der in der Variable
REDMINE_DB_MYSQLzugewiesene Name stimmt nicht exakt mit der Dienstnamendeklaration in der Compose-Datei überein.
- Der in der Variable
- 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
999konfiguriert, um Schreibfehler zu vermeiden. - ✓ Robuste Sitzungsgeheimnisse: Variable
SECRET_KEY_BASEwurde mit OpenSSL generiert und ist von öffentlichen Umgebungen isoliert. - ✓ Aktive Netzwerksockets: Sichere Abbildung auf Port
5588mit korrekter Umleitung von Rails-Logs. - ✓ Kopplungsorchestrierung: Hauptanwendungsdienst durch Direktive
depends_onblockiert, bis MySQL erfolgreich initialisiert ist.

