Ir al contenido

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.

0vues

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 :

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo 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 777 sur 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 :

Ventana de terminal
openssl rand -hex 64

Copiez 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.


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) :

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

Docker 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.


Assurez-vous de la bonne mise en route des services à l'aide des commandes tactiques de débogage :

Ventana de terminal
docker compose ps

Critère de réussite : Les deux conteneurs (redmine et redmine_db) doivent afficher l'état Up ou healthy.

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 :

Ventana de terminal
docker compose logs -f redmine

Sortie 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.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.
  • Solution : Arrêtez le moteur (docker compose down), vérifiez les logs d'erreur détaillés du socket via docker compose logs et relancez la correction des permissions avec chown -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_MYSQL ne correspond pas exactement à la déclaration du nom du service dans le fichier Compose.
  • 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 999 pour éviter les exceptions d'écriture.
  • ✓ Secrets de session robustes : Variable SECRET_KEY_BASE générée avec OpenSSL et isolée des environnements publics.
  • ✓ Sockets réseau actifs : Mapping sécurisé sur le port 5588 ré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_on jusqu'à l'initialisation réussie de MySQL.