Loading search data...

Premiers pas avec Ansible AWX

logo ansible

Maintenant que nous avons installé AWX sur notre cluster Kubernetes, voyons comment l’utiliser. Nous allons tout simplement voir comment créer les hosts, les inventaires, les crédentials, un projet, un environnement d’exécution et lancer un job s’appuyant sur un playbook du projet.

Prérequis à la démonstration

Mise en place du projet de démonstration

Pour démarrer rapidement je vous ai préparé un petit projet sur github à cette adresse : https://github.com/stephrobert/test-awx

Cloner le projet :

git clone https://github.com/stephrobert/test-awx.git

Si vous avez manqué le billet sur les environnements d’exécution d’Ansible je vous renvoie à sa lecture avant de passer à la suite.

Vous êtes prêt ? Oui alors, lançons le build de notre environnement d’exécution qui contient les collections suivantes (requirements.yml) :

  • community.general
  • kubernetes.core
  • ansible.posix

et le modules python kubernetes (requirements.txt)

Changer le nom de l’image avec l’adresse de votre registry. J’ai fait simple, je l’ai installé dans le cluster kubernetes.

ansible-builder build --tag=devbox2.robert.local:31320/my-custom-ee:1.0.0

docker push devbox2.robert.local:31320/my-custom-ee:1.0.0

Vérifions que l’image est bien présente dans notre registry :

curl https://devbox2.robert.local:31320/v2/_catalog
{"repositories":["my-custom-ee"]}

C’est tout qu’il y a à faire.

Création de l’environnement d’exécution sur AWX

Il suffit de se rendre dans le menu Administration / Environnements d’exécution. Cliquez sur [Ajouter] puis renseigner les valeurs :

  • Nom : kubernetes-EE
  • Image : devbox2.robert.local:31320/my-custom-ee:1.0.0

Pour finir, cliquer sur [Enregistrer].

AWX environnement d’exécution

Création des crédentials

Récupérer votre clé privé SSH (pas le .pub) qui est déclaré sur l’ensemble des Hosts cibles de vos playbooks et copiez là.

Dans le menu Ressources / informations d’identification cliquez sur [Ajouter] :

  • Nom : SSH-kubernetes
  • Type d’informations d’identification : Machine
  • Nom d’utilisateur : Le user qui porte la clé SSH, moi malade que je suis j’ai mis root
  • Clé Privé SSH : Coller le contenu de votre clé privée
  • Si vous mis une paraphrase alors ajoutez la
  • Méthode d’esclade : sudo

Cliquer sur [Enregistrer].

AWX Crédential SSH

Création des inventaires / hôtes

Dans le menu Ressources / Inventaires, cliquez sur [Ajouter] un inventaire simple puis renseigner les valeurs :

  • Nom : cluster-kubernetes
  • Organisation : Défaut

Pour finir, cliquer sur [Enregistrer].

AWX Inventaire

Cliquer maintenant sur [Hôtes] dans la partie détail de l’inventaire. Puis sur [Ajouter] et entrez le nom de votre Host cible et cliquer sur [Enregistrer]. Puis [retour aux hôtes].

AWX Hote

Pour tester nous allons lancer un module Ansible. Cliquez sur [Exécuter Commande] :

  • Modules : setup puis [Suivant]
  • Environnement d’Exécution : kubernetes-EE puis [Suivant]
  • Information d’identification : SSH-kubernetes puis [Suivant]
  • [Lancer]

Normalement vous basculez dans le menu Affichages / Jobs. Au bout d’un instant le job devrait se terminer avec succès et vous devriez voir les facts.

AWX Execution Commande

Ajout d’un projet Git

Nous allons ajouter le projet que je vous ai préparé. Dans le menu Ressources / Projets cliquez sur [Ajouter] :

  • Nom : get-running-pods
  • Environnement d’Execution : kubernetes-EE
  • Type de Contrôle de source : Git
  • Url Contrôle de la source : https://github.com/stephrobert/test-awx.git
  • Branche / Tag : y en a pas

Pour finir, cliquer sur [Enregistrer]. Normalement, il va lancer une synchronisation pour récupérer le projet.

AWX Projet

Création d’un Template de Job

Nous allons ajouter un modèle de Job . Dans le menu Ressources / Modèles cliquez sur [Ajouter] un modèle de Job :

  • Nom : Get running Pod
  • Inventaire : cluster-kubernetes
  • Playbook: site.yml
  • Information d’identification : SSH-kubernetes puis le reste par défaut.

Pour finir, cliquer sur [Enregistrer].

AWX Modèles

Nous allons l’exécuter pour la première fois. Cliquez sur [Lancer]. Comme tout à l’heure nous basculons dans le menu Affichages / Jobs :

AWX Modèles

Ajouter une programmation d’un Modèle

Les modèles peuvent être schédulé. Dans le menu Ressources / Modèles cliquez sur le modèle créé précédemment, puis dans l’onglet [Programmations] et [Ajouter] :

  • Nom : Get Running Pod Lundi
  • Fuseau Horaire Local : le vôtre
  • Start date/time : par défaut quelques minutes plus tard que l’heure actuelle
  • Fréquence d’exécution : Semaine
  • Exécutez tous les : 1
  • Tels Jours : Lun
  • Fin : Nbre d'occurences
  • Occurences : 2

Nous avons créé la programmation d’un job pour les deux prochains Lundi à une heure précise.

Conclusion

La création et l’utilisation des environnement d’exécution permettent de simplifier énormément la gestion des noeuds master Ansible. Plus besoin d’installer tout sur ces noeuds. En plus, on peut gérer finement la version des modules et de la partie Core d’Ansible.

Je suis sûr que vous avez déjà plein de Uses Cases en tête. La prochaine fois nous verrons :

  • Créer des users
  • Comment créer des Workflows ou Flux d’activité.
  • Mettre en place des Approbations
  • Envoyer des notifications

A la prochaine fois !


Si vous avez apprécié cet article de blog, vous pouvez m'encourager à produire plus de contenu en m'offrant un café sur   Ko-Fi  . Vous pouvez aussi passer votre prochaine commande sur amazon, sans que cela ne nous coûte plus cher, via   ce lien  . Vous pouvez aussi partager le lien sur twitter ou linkedin via les boutons ci-dessous. Je vous remercie de votre soutien


Mots clés :

devops ansible tutorials infra as code formation ansible

Autres Articles


Commentaires: