**Contexte technique :**- **Base OS :** CentOS Stream 9 (Image officielle AWX-EE)
- **Registry :** Harbor (docker-registry.numericare.fr)
- **Outils :** Docker CLI, Ansible-Galaxy
- **proxmoxer :** Librairie Python pour l'API Proxmox.
- **community.docker (v3.4.0+) :** Pour le support de `docker_compose_v2`.
- **community.proxmox :** Pour la gestion des LXC et VMs.
## 2. Le Dockerfile de construction
Nous utilisons la méthode manuelle (Dockerfile) plutôt qu'Ansible-Builder pour éviter les conflits de dépendances lourdes (oVirt, etc.) et optimiser l'espace disque.
```
FROM quay.io/ansible/awx-ee:latest
# Passage en root pour l'installation système
USER root
# 1. Installation de PIP et des librairies Python requises
RUN dnf install -y python3-pip && \
python3 -m pip install --no-cache-dir proxmoxer requests
# 2. Installation des collections Ansible dans le répertoire GLOBAL
# Note : le flag -p est crucial pour que l'utilisateur non-root d'AWX y accède
RUN ansible-galaxy collection install community.docker:'>=3.4.0' -p /usr/share/ansible/collections --upgrade && \
ansible-galaxy collection install community.proxmox -p /usr/share/ansible/collections
# Repassage sur l'utilisateur AWX par défaut (UID 1000)
USER 1000
```
## 3. Build et Push vers Harbor
Commandes à exécuter depuis le nœud de build (ex: `squall`) :
```
# 1. Connexion à la registry
docker login docker-registry.numericare.fr
# 2. Construction de l'image
docker build -t docker-registry.numericare.fr/private/custom-awx-ee:v1.0 .
# 3. Envoi sur Harbor
docker push docker-registry.numericare.fr/private/custom-awx-ee:v1.0
```
## 4. Configuration dans AWX
Une fois l'image sur Harbor, il faut la déclarer dans l'interface AWX :
1. **Créer le Credential :**
- Type : *Container Registry*
- URL : `https://docker-registry.numericare.fr`
2. **Créer l'Execution Environment :**
- Image : `docker-registry.numericare.fr/private/custom-awx-ee:v1.0`
- Pull : `Always pull`
- Registry Credential : Sélectionner celui créé à l'étape précédente.
3. **Assigner :** Modifier le *Job Template* pour utiliser ce nouvel EE.
## ⚠️ Troubleshooting & Pièges
#### 1. Espace disque saturé (No space left on device)
Le build d'images crée beaucoup de cache. Sur le nœud de build, lancer régulièrement :
**Objectif :** Comprendre et utiliser Molecule pour tester des rôles Ansible de manière automatisée, reproductible et fiable.
---
## 1. Qu’est-ce que Molecule ?
Molecule est un framework de test pour **rôles Ansible**. Il permet de vérifier automatiquement qu’un rôle fonctionne correctement dans un environnement simulé (Docker, Podman, LXC ou VM).
Il fait partie de l’écosystème Ansible et est utilisé pour :
- tester des rôles Ansible
- valider des infrastructures de manière reproductible
- automatiser les tests CI/CD
- éviter les régressions en production
---
## 2. Pourquoi utiliser Molecule ?
**Sans Molecule :**- Tests manuels des rôles
- Erreurs découvertes en production
- Aucune reproductibilité
**Avec Molecule :**- Tests automatisés
- Environnements jetables
- Validation systématique des rôles
---
## 3. Le cycle Molecule (IMPORTANT)
Molecule fonctionne selon un cycle standard :
```
create → converge → verify → destroy
```
**Commande globale :** `molecule test` exécute tout automatiquement.
---
## 4. Architecture d’un rôle avec Molecule
```
role/
└── molecule/
└── default/
├── molecule.yml
├── converge.yml
├── verify.yml
```
- `molecule.yml` → configuration du scénario
- `converge.yml` → exécution du rôle
- `verify.yml` → tests automatisés
---
## 5. Installation
```
pip install molecule molecule-docker
# ou
pip install molecule molecule-podman
```
---
## 6. Création d’un rôle + Molecule
```
ansible-galaxy init my_role
cd my_role
molecule init scenario default
```
---
## 7. Exemple molecule.yml
```
driver:
name: docker
platforms:
- name: instance
image: geerlingguy/docker-ubuntu2204-ansible
privileged: true
provisioner:
name: ansible
verifier:
name: ansible
```
---
## 8. Exemple converge.yml
```
- name: Converge
hosts: all
tasks:
- name: Include role
include_role:
name: my_role
```
---
## 9. Exemple verify.yml
```
- name: Verify nginx installation
hosts: all
tasks:
- name: Check nginx version
command: nginx -v
register: result
changed_when: false
- name: Assert nginx is installed
assert:
that:
- result.rc == 0
```
---
## 10. Commandes essentielles
```
molecule create
molecule converge
molecule verify
molecule destroy
molecule test
```
---
## 11. Debug
```
molecule login
molecule destroy
molecule test --debug
```
---
## 12. Drivers disponibles
- Docker (standard)
- Podman (rootless)
- LXC (possible mais complexe)
- VM (Vagrant)
**Attention :** Docker dans LXC nécessite nesting=1 côté Proxmox.
---
## 13. Bonnes pratiques
- 1 rôle = 1 scénario Molecule
- toujours ajouter verify.yml
- tester plusieurs distributions si possible
- intégrer CI/CD
---
## 14. Résumé
Molecule transforme un rôle Ansible en système testable automatiquement.
- ✔ Moins d’erreurs en production
- ✔ Tests reproductibles
- ✔ Infra industrialisée