WIP

ansible/README.md

@@ -0,0 +1,40 @@
+### Installation d'Ansible avec pipx
+
+1. Désinstaller *Ansible* et *ansible-lint* s'ils sont déjà installés. Par
+  exemple avec *Homebrew*:
+    ```
+    brew uninstall ansible ansible-lint
+    ```
+1. Installer *pipx*. Par exemple avec *Homebrew*:
+    ```
+    brew install pipx
+    ```
+1. Inscrire le chemin de recherche des exécutables de *pipx* dans les
+  scripts d'ouverture de session (fermer le shell et en ouvrir un nouveau
+  pour activer ce chemin de recherche):
+    ```
+    pipx ensurepath
+    ```
+1. Installer *Ansible* (version 11, et au moins version core 2.16.9, pour
+   être compatible avec *Mitogen*) dans un environnement isolé (qui sera
+   nommé `ansible`) puis injecter *ansible-lint* et les librairies requises
+   dans cet environnement: 
+    ```
+    pipx install ansible==12.3.0 --include-deps
+    pipx inject ansible ansible-lint --include-apps
+    pipx inject ansible requests
+    pipx inject ansible pip-system-certs
+    pipx inject ansible passlib    # pour |password_hash sur macOS (et autres)
+    pipx inject ansible jmespath   # pour |query_result
+    pipx inject ansible pytz       # pour plugin inventory auto
+    pipx inject ansible pynetbox   # pour collection netbox.netbox
+    pipx inject ansible netaddr    # pour les rôles CheckMK
+    pipx inject ansible mitogen    # optionnel, pour utiliser Mitogen
+    ```
+
+1. Vérifier l'environnement:
+    ```
+    pipx list --include-injected
+    ansible --version  -> ansible [core 2.16.9]
+    ansible-lint --version  -> ansible-lint 24.7.0
+    ```