ansible: Set required ansible and ansible-core versions

ansible-core 2.17 drops support for Python2 and Python 3 < 3.7. Python
2 is used for SLES12, and Python 3.6 is used on EL8.

Change-Id: Ic233ecb219caf46117c3d5bbdd2ec1f2ca5045c3
Signed-off-by: Kienan Stewart <kstewart@efficios.com>

diff --git a/automation/ansible/README.md b/automation/ansible/README.md
index 1204bacdc4e87eda3f36da5cef89b9a9ced13df4..cf434a05def20a0f6310cccfbb27f2971ec7631c 100644 (file)
--- a/automation/ansible/README.md
+++ b/automation/ansible/README.md
@@ -1,16 +1,25 @@
-# Setup on Ubuntu
+# Setup
 
-```
-apt install ansible ansible-mitogen
-```
+1. Install system requirements
 
-# Required collections
+    apt install python3-pip
 
-```
-ansible-galaxy install -r roles/requirements.yml
-```
+2. Install project dependencies
+
+    pip3 install --user requirements.txt # --break-system-packages
+    # Note: --break-system-packages is required on recent Debian versions
+
+3. (Optional) Install mitogen on Debian/Ubuntu:
+
+    apt install ansible-mitogen
+
+4. Install required ansible collections
+
+    ansible-galaxy install -r roles/requirements.yml
+
+5. Install the Bitwarden command-line client
 
-# Privileged data
+## Privileged data
 
 Privileged data is stored in Bitwarden. To use roles that fetch privileged data,
 the following utilities must be available:

diff --git a/automation/ansible/requirements.txt b/automation/ansible/requirements.txt
new file mode 100644 (file)
index 0000000..a42d288
--- /dev/null
+++ b/automation/ansible/requirements.txt
@@ -0,0 +1,2 @@
+ansible==9.13.0
+ansible-core==2.16.14