Documentation - Stack Web automatisée¶

Terraform + Ansible + Nginx Reverse Proxy + Pipeline Jenkins/Gitea¶

Minikube local · Gitea 192.168.1.37:3000 · Jenkins 192.168.1.37:8080

1. Gitea - Les 3 dépôts¶

1.1 Vue d'ensemble des dépôts¶

Les 3 dépôts créés dans l'espace utilisateur std sur Gitea :

1.2 Dépôt terraform-infra¶

Il contient tout le code Terraform pour la VM et les services Kubernetes :

1.3 Dépôt ansible-config¶

Contient les playbooks Ansible pour configurer la VM provisionnée par Terraform :

1.4 Dépôt proxy-deploy - Dépôt principal¶

Il est pointé par Jenkins :

1.5 Le Jenkinsfile dans Gitea¶

Le Jenkinsfile stocké dans proxy-deploy :

Les premières lignes définissent les variables d'environnement vers les 3 repos Gitea :

environment {
    GITEA_BASE   = 'http://192.168.1.37:3000/std'
    TF_REPO      = 'terraform-infra'
    ANSIBLE_REPO = 'ansible-config'
    PROXY_REPO   = 'proxy-deploy'
    SSH_KEY_ID   = 'ansible-ssh-key'
}

2. Jenkins - Configuration du job¶

2.1 Paramètres généraux du job¶

La section "Pipeline" sur la page de configuration du job devops-stack-pipeline :

3. Description des 7 étapes du pipeline¶

Étape 1 - Checkout¶

Clone les 3 repos depuis Gitea dans des sous-dossiers du workspace Jenkins :

• proxy-deploy → racine
• terraform-infra → ./terraform/
• ansible-config → ./ansible/

Étape 2 - Validaate¶

terraform validate + terraform fmt -check → vérifie la syntaxe HCL

ansible-playbook --syntax-check → vérifie la syntaxe YAML

Étape 3 - Apply¶

terraform init
terraform plan -out=tfplan
terraform apply -auto-approve tfplan
MINIKUBE_IP=$(minikube ip)
echo "MINIKUBE_IP=${MINIKUBE_IP}" > ../deploy.env

Crée le Pod Debian (VM Linux) avec ses services. IP dans deploy.env

Étape 4 - Generate Inventory¶

Remplace le placeholder MINIKUBE_IP dans inventory.ini :

sed -i "s/MINIKUBE_IP/${MINIKUBE_IP}/g" inventory.ini

Étape 5 - Ansible Configure¶

Lance le playbook sur la VM :

ansible-playbook -i inventory.ini \
    --private-key "$SSH_KEY_FILE" \
    --user "$SSH_USER" \
    playbook.yml -v

Étape 6 - Deploy Reverse Proxy¶

Entre l'IP dans nginx.conf puis lance le container :

sed -i "s/VM_IP/${MINIKUBE_IP}/g" nginx.conf
docker compose up -d --force-recreate

Étape 7 - Test¶

Vérif avec curl à travers le reverse proxy :

STATUS=$(curl -s -o /tmp/body.html -w "%{http_code}" http://${MINIKUBE_IP}:80)

Il faut vérifier que l'on obtnient "HTTP 200" et "Secure Web Stack" dans le body

4. Credential SSH requis dans Jenkins¶

Avant la 1ère éxécution, ajouter le credential SSH dans : Manage Jenkins → Credentials → System → Global → Add Credentials

5. Lancer le pipeline¶

Sur le job devops-stack-pipeline dans Jenkins :

1. Cliquer sur "Build Now" dans le menu gauche
2. Suivre l'exécution dans "Build History" puis les logs de chaque étape
3. En cas de succès, affiche :

6.Détruire¶

Pour supprimer toute la stack :

cd proxy-deploy/
docker compose down

cd terraform/
terraform destroy -auto-approve

Ou fazire un job Jenkins dédié destroy avec when: manual pour détruire en un clic depuis l'interface.