🛠️ Installation de AWX avec Ansible et Docker¶
AWX est l’interface web open-source pour Ansible. Cette documentation détaille pas à pas son installation sur Debian 12.
✅ Prérequis¶
Avant de commencer, assurez-vous d’avoir :
- Un système Debian 12
- Les droits root ou un utilisateur avec
sudo - Une connexion Internet fonctionnelle
1️⃣ Ajouter le dépôt Ansible¶
Ansible n’est pas disponible par défaut sous Debian. Voici comment l’ajouter.
📦 Installer les dépendances¶
apt-get install apt-transport-https ca-certificates software-properties-common unzip gnupg2 curl git -y
📝 Modifier le fichier sources.list¶
nano /etc/apt/sources.list
Ajoutez à la fin :
deb http://ppa.launchpad.net/ansible/ansible/ubuntu focal main
🔑 Ajouter la clé GPG¶
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 93C4A3FD7BB9C367
🔄 Mettre à jour les paquets¶
apt-get update -y
2️⃣ Installer Ansible & Docker¶
⚙️ Installation d’Ansible¶
apt-get install ansible -y
ansible --version
🐳 Installation de Docker¶
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
🔍 Vérification de l’état de Docker¶
systemctl status docker
3️⃣ Installer Docker Compose & dépendances¶
📥 Télécharger Docker Compose¶
wget https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-linux-x86_64
mv docker-compose-linux-x86_64 /usr/bin/docker-compose
chmod +x /usr/bin/docker-compose
docker-compose version
🔧 Installer Node.js, NPM et autres outils¶
apt-get install nodejs npm -y
npm install npm --global
apt-get install python3-pip git pwgen -y
🐍 Installer Docker Compose via pip¶
pip3 install docker-compose==2.27.0
4️⃣ Installation de AWX¶
⬇️ Télécharger AWX¶
wget https://github.com/ansible/awx/archive/refs/tags/17.1.0.zip
unzip 17.1.0.zip
cd awx-17.1.0/installer/
🔐 Générer une clé secrète¶
pwgen -N 1 -s 30
📝 Modifier le fichier inventory¶
nano inventory
Modifiez les lignes suivantes :
admin_user=admin
admin_password=motdepasse
secret_key=VOTRE_CLÉ_SECRÈTE_GÉNÉRÉE
💡 Utilisez un mot de passe fort et conservez la clé en lieu sûr.
🚀 Lancer le Playbook Ansible¶
ansible-playbook -i inventory install.yml
Ce playbook configure AWX et lance les conteneurs nécessaires.
🔍 Vérifications post-installation¶
📦 Lister les images Docker¶
docker images
📂 Afficher les conteneurs en cours¶
docker ps
🌐 Accès à l’interface AWX¶
Une fois installé, ouvrez votre navigateur à l’adresse :
http://<ip-serveur> ou https://<nom-domaine>
Utilisez les identifiants définis dans le fichier inventory :
- Utilisateur :
admin - Mot de passe : celui que vous avez défini
✅ Conclusion¶
AWX est maintenant installé et prêt à l’emploi. Vous pouvez créer vos inventaires, projets, modèles de tâches, et commencer à orchestrer votre infrastructure via une interface web intuitive.