TP7 - Déploiement Ansible complet avec scripts PowerShell et documentation

2025-10-16 15:14:09 +04:00
parent 37199521e4
commit 5a879b7db1
28 changed files with 3810 additions and 0 deletions
@@ -0,0 +1,217 @@
+# 🚀 Quick Start - Déploiement en 5 Minutes
+
+Guide rapide pour déployer DockeZR sur votre serveur en 5 minutes chrono.
+
+---
+
+## ⚡ Déploiement Rapide
+
+### 1️⃣ Prérequis (2 min)
+
+```bash
+# Sur Windows, installer WSL + Ansible
+wsl --install
+# Redémarrer Windows, puis dans WSL:
+sudo apt update && sudo apt install ansible -y
+```
+
+### 2️⃣ Configuration (2 min)
+
+```bash
+# Naviguer vers le dossier
+cd /mnt/c/Users/lou/Documents/Projet/dockeer/dockezr/ansible
+
+# Éditer l'inventaire
+nano inventory.ini
+# Remplacer: VOTRE_IP_SERVEUR, VOTRE_USER
+
+# Éditer les variables
+nano group_vars/all.yml
+# Modifier: project_repo, mots de passe
+
+# Permissions SSH
+chmod 600 ../../sskdockerz/ssh-key-2025-10-16.key
+```
+
+### 3️⃣ Test de Connexion (30 sec)
+
+```bash
+ansible all -i inventory.ini -m ping
+```
+
+✅ Devrait afficher: `"ping": "pong"`
+
+### 4️⃣ Déploiement (5-10 min)
+
+```bash
+ansible-playbook -i inventory.ini deploy.yml
+```
+
+### 5️⃣ Vérification (30 sec)
+
+```bash
+# Ouvrir dans le navigateur:
+# http://VOTRE_IP:3000
+# http://VOTRE_IP:8001/docs
+```
+
+---
+
+## 📋 Commandes Essentielles
+
+### Déploiement
+
+```bash
+# Déploiement complet
+ansible-playbook -i inventory.ini deploy.yml
+
+# Avec mode verbeux
+ansible-playbook -i inventory.ini deploy.yml -v
+
+# Test en local d'abord
+ansible-playbook -i inventory.local.ini deploy.yml
+```
+
+### Gestion
+
+```bash
+# Arrêter
+ansible-playbook -i inventory.ini deploy.yml --tags stop
+
+# Reconstruire
+ansible-playbook -i inventory.ini deploy.yml --tags build,start
+
+# Test connexion
+ansible all -i inventory.ini -m ping
+```
+
+### Sur le Serveur
+
+```bash
+# Connexion SSH
+ssh -i ../../sskdockerz/ssh-key-2025-10-16.key USER@IP
+
+# Voir les conteneurs
+docker ps
+
+# Voir les logs
+cd /opt/dockezr
+docker compose -f docker-compose.prod.yml logs -f
+
+# Redémarrer
+docker compose -f docker-compose.prod.yml restart
+```
+
+---
+
+## 🎯 URLs des Services
+
+Remplacez `VOTRE_IP` par l'adresse IP de votre serveur:
+
+| Service | URL | Identifiants |
+|---------|-----|--------------|
+| **Frontend** | http://VOTRE_IP:3000 | - |
+| **API** | http://VOTRE_IP:8001 | - |
+| **Swagger** | http://VOTRE_IP:8001/docs | - |
+| **Prometheus** | http://VOTRE_IP:9090 | - |
+| **Grafana** | http://VOTRE_IP:3001 | admin / [votre_mdp] |
+
+---
+
+## 🐛 Dépannage Express
+
+| Problème | Solution |
+|----------|----------|
+| ❌ Permission denied | `chmod 600 ../../sskdockerz/ssh-key-2025-10-16.key` |
+| ❌ Host unreachable | Vérifier IP dans `inventory.ini` et `ping VOTRE_IP` |
+| ❌ sudo password | Ajouter `--ask-become-pass` |
+| ❌ Conteneurs ne démarrent pas | SSH au serveur + `cd /opt/dockezr` + `docker compose logs` |
+
+---
+
+## 📸 Captures pour le Livrable
+
+```bash
+# 1. Exécution du playbook
+ansible-playbook -i inventory.ini deploy.yml
+# 📸 Capturer le terminal avec "PLAY RECAP" SUCCESS
+
+# 2. Sur le serveur
+ssh -i ../../sskdockerz/ssh-key-2025-10-16.key USER@IP
+docker ps
+# 📸 Capturer la liste des conteneurs running
+
+# 3. Dans le navigateur
+# 📸 http://VOTRE_IP:3000
+# 📸 http://VOTRE_IP:8001/docs
+```
+
+---
+
+## ✅ Checklist Livrable TP7
+
+- [ ] `deploy.yml` commenté (✅ déjà fait)
+- [ ] `inventory.ini` configuré
+- [ ] `group_vars/all.yml` configuré
+- [ ] Test connexion SSH réussi
+- [ ] Playbook exécuté avec succès
+- [ ] Capture: terminal avec PLAY RECAP
+- [ ] Capture: docker ps sur le serveur
+- [ ] Capture: application dans le navigateur
+- [ ] Documentation: README.md dans ansible/
+
+---
+
+## 🎓 Ce que fait le Playbook
+
+1. ✅ Mise à jour du système
+2. ✅ Installation de Docker + Docker Compose
+3. ✅ Configuration des permissions
+4. ✅ Clonage du repository GitHub
+5. ✅ Configuration des variables d'environnement
+6. ✅ Build des images Docker
+7. ✅ Lancement de l'application
+8. ✅ Vérification et affichage des logs
+
+**Tout est automatisé! 🎉**
+
+---
+
+## 🚀 Aller Plus Loin
+
+### Sécuriser les Secrets
+
+```bash
+# Chiffrer les variables sensibles
+ansible-vault encrypt group_vars/all.yml
+
+# Exécuter avec vault
+ansible-playbook -i inventory.ini deploy.yml --ask-vault-pass
+```
+
+### Configurer un Pare-feu
+
+```bash
+# Sur le serveur
+sudo ufw allow 22/tcp
+sudo ufw allow 3000/tcp
+sudo ufw allow 8001/tcp
+sudo ufw enable
+```
+
+### Sauvegardes Automatiques
+
+```bash
+# Ajouter un cron sur le serveur
+0 2 * * * docker exec dockezr_db pg_dump -U user dockezr > /backup/dockezr_$(date +\%Y\%m\%d).sql
+```
+
+---
+
+**Bon déploiement! 🎉**
+
+Pour plus de détails, consultez:
+- 📖 `GUIDE_EXECUTION.md` - Guide détaillé pas à pas
+- 📘 `README.md` - Documentation complète
+- 🔧 `deploy.sh` - Script interactif
+