DOC-03: Déploiement, Sécurité et Mise en service
Procédure tactique et bonnes pratiques de sécurité pour l'approvisionnement des permissions locales, la génération immuable de secrets et le démarrage contrôlé de la pile Redmine.
1. Gestion des permissions (Étape critique sous Linux)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»Contrairement à d'autres systèmes de fichiers d'environnements de test, les volumes montés dans des conteneurs dans les environnements Linux d'entreprise exigent une attribution stricte de propriété et de permissions pour garantir la sécurité. Le moteur interne de Redmine exécute ses threads sous un utilisateur système isolé avec l'identifiant (UID/GID) 999.
Si nous omettons le changement de propriétaire sur l'hôte Ubuntu, l'application démarrera, mais échouera immédiatement en tentant d'écrire des pièces jointes, de compiler des feuilles de style personnalisées ou de déverser des traces de logs, provoquant des exceptions silencieuses dans la base de données.
Avant d'initialiser l'infrastructure, exécutez la commande d'assainissement des permissions depuis le répertoire de travail dans le terminal de l'hôte :
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] Sécurité d'Accès : N'attribuez en aucun cas des autorisations permissives globales du type
chmod -R 777sur ces dossiers dans les environnements d'entreprise. Cela ouvrirait des vecteurs de vulnérabilité graves pour l'injection de fichiers distante si un plugin Redmine présentait des failles de sécurité.
2. Génération immuable de secrets (Sessions Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine stocke les jetons de session de manière chiffrée dans les cookies du client via la clé déclarative SECRET_KEY_BASE. Pour éviter le détournement de session ou l'interception malveillante dans le navigateur, cette clé doit présenter une entropie élevée et être maintenue complètement immuable et secrète.
Si, à l'avenir, vous devez régénérer la clé en raison d'un audit périodique de cybersécurité, exécutez la commande d'aléatoire cryptographique sécurisée :
openssl rand -hex 64Copiez le bloc alphanumérique résultant et mettez immédiatement à jour la variable SECRET_KEY_BASE dans votre fichier docker-compose.yml avant le redémarrage de la pile.
3. Mise en route de la stack
Sección titulada «3. Puesta en Marcha del Stack»Pour compiler, structurer et démarrer les dépendances réseau isolées et les conteneurs de persistance en mode démon (en arrière-plan) :
cd ~/redminedocker compose up -dDocker Compose créera automatiquement les réseaux virtuels, montera les volumes configurés et attendra que le moteur de base de données MySQL soit prêt pour initialiser la structure SQL de Redmine.
4. Diagnostic d'état et traces de logs
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»Assurez-vous de la bonne mise en route des services à l'aide des commandes tactiques de débogage :
4.1. Vérification des conteneurs actifs
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psCritère de réussite : Les deux conteneurs (redmine et redmine_db) doivent afficher l'état Up ou healthy.
4.2. Audit des traces en temps réel
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Pour surveiller de manière analytique le processus d'initialisation de la base de données et la migration interne des tables exécutée par Rails :
docker compose logs -f redmineSortie Attendue : Recherchez à la fin du flux l'enregistrement des sockets actifs :
Listening on 0.0.0.0:3000 (qui est mappé en externe au port sécurisé de l'entreprise 5588).
5. Résolution des conflits courants (Dépannage)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. Le conteneur entre dans une boucle de redémarrages
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- Causes Fréquentes :
- Manque de permissions du propriétaire dans les répertoires partagés de l'hôte (omission de la commande
chown). - Erreurs d'indentation syntaxique dans le fichier YAML de
docker-compose.yml.
- Manque de permissions du propriétaire dans les répertoires partagés de l'hôte (omission de la commande
- Solution : Arrêtez le moteur (
docker compose down), vérifiez les logs d'erreur détaillés du socket viadocker compose logset relancez la correction des permissions avecchown -R 999:999.
5.2. Erreur de connexion à la base de données
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Cause Fréquente :
- Le nom assigné à la variable
REDMINE_DB_MYSQLne correspond pas exactement à la déclaration du nom du service dans le fichier Compose.
- Le nom assigné à la variable
- Solution : Ouvrez le fichier d'orchestration et vérifiez que les deux blocs partagent l'identifiant DNS unifié :
redmine_db.
📊 Checklist de réussite du déploiement
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Propriété des fichiers correcte : Tous les répertoires montés sont configurés avec l'UID/GID
999pour éviter les exceptions d'écriture. - ✓ Secrets de session robustes : Variable
SECRET_KEY_BASEgénérée avec OpenSSL et isolée des environnements publics. - ✓ Sockets réseau actifs : Mapping sécurisé sur le port
5588répondant correctement avec la redirection des logs Rails. - ✓ Orchestration couplée : Le service d'application principal est empêché de démarrer immédiatement via la directive
depends_onjusqu'à l'initialisation réussie de MySQL.

