Documentation de déploiement avec Ansible

Ce guide explique comment utiliser Ansible pour déployer facilement le projet ÉvalueTonSavoir.

Prérequis

Système requis

Un ordinateur sous Linux ou Mac.
Pour Windows, installez WSL2 afin d'exécuter un environnement Ubuntu.

Installation d'Ansible

Sur Ubuntu (ou WSL2) : Utilisez le gestionnaire de paquets apt :
```
sudo apt update
sudo apt install ansible-core
```
Autres systèmes : Consultez la documentation officielle d'Ansible pour connaître les étapes spécifiques à votre système.

Installation de Docker et Docker Compose

Suivez la documentation Docker officielle pour installer Docker.
Docker Compose est inclus comme plugin Docker dans les versions récentes.

Téléchargement des fichiers nécessaires

Clonez le dépôt Git contenant les fichiers Ansible :

git clone https://github.com/ets-cfuhrman-pfe/EvalueTonSavoir

Naviguez vers le répertoire ansible :
```
cd EvalueTonSavoir/ansible
```

Déploiement avec Ansible

Commande de déploiement

Pour déployer l'application, exécutez la commande suivante dans le répertoire contenant le fichier deploy.yml :

ansible-playbook -i inventory.ini deploy.yml

Structure des fichiers utilisés

inventory.ini : Défini les cibles du déploiement. Par défaut, il est configuré pour un déploiement local.
deploy.yml : Playbook contenant les instructions pour installer, configurer et déployer l'application.

Étapes effectuées par Ansible

Installation des dépendances :
- Vérifie et installe Docker si nécessaire.
Démarrage des services :
- Télécharge le fichier docker-compose.yaml depuis le dépôt Github.
- Lance les services définis avec Docker Compose.
Vérification des conteneurs :
- Vérifie que les conteneurs sont en cours d'exécution et fonctionnent correctement.

Vérification du déploiement

Une fois le playbook exécuté, Ansible :

Installe Docker et ses dépendances.
Télécharge et configure le projet.
Lance les services avec Docker Compose.
Vérifie que les services sont accessibles localement.

Pour tester l'application, utilisez la commande suivante :

curl http://localhost:8080

Un code de réponse 200 OK indiquera que le déploiement est réussi.

Résumé

Le déploiement avec Ansible simplifie la gestion des configurations et l'installation des dépendances nécessaires pour le projet ÉvalueTonSavoir. Avec cette méthode, vous pouvez déployer rapidement l'application dans un environnement local tout en assurant une configuration cohérente.

2.9 KiB Raw Blame History