From 80ba276023fc9610a3bcaefa3a19336f1604e892 Mon Sep 17 00:00:00 2001
From: Craig Comstock <craig.comstock@northern.tech>
Date: Thu, 20 Aug 2026 16:26:43 -0500
Subject: [PATCH] ent-14328: organize install-ansible module into a directory
 to enable the required README for build-index

---
 cfbs.json                                         |  6 +++---
 software/install-ansible/README.md                | 15 +++++++++++++++
 software/{ => install-ansible}/install-ansible.cf |  0
 3 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 software/install-ansible/README.md
 rename software/{ => install-ansible}/install-ansible.cf (100%)

diff --git a/cfbs.json b/cfbs.json
index 5f263a43..372655b5 100644
--- a/cfbs.json
+++ b/cfbs.json
@@ -548,10 +548,10 @@
     },
     "install-ansible": {
       "description": "Optionally install ansible.",
-      "subdirectory": "software",
+      "subdirectory": "software/install-ansible",
       "steps": [
-        "copy install-ansible.cf services/cfbs/software/install-ansible.cf",
-        "policy_files services/cfbs/software/install-ansible.cf",
+        "copy install-ansible.cf services/cfbs/software/install-ansible/install-ansible.cf",
+        "policy_files services/cfbs/software/install-ansible/install-ansible.cf",
         "bundles install_ansible"
       ]
     },
diff --git a/software/install-ansible/README.md b/software/install-ansible/README.md
new file mode 100644
index 00000000..d5f72428
--- /dev/null
+++ b/software/install-ansible/README.md
@@ -0,0 +1,15 @@
+This module ensures that Ansible is installed on a system.
+
+## Configuration
+
+There are three classes which can be used to specify whether to install ansible and which version: minimal or full.
+
+- `data:install_ansible` - if defined, install ansible (default is full install)
+- `data:ansible_minimal_install` - if defined, install minimal version aka ansible-core
+- `data:ansible_full_install` - if defined, install full version.
+
+Additionally it is possible to request a specific version other than the latest/default by way of a variable.
+
+- `data:install_ansible.version` - if this variable is defined then a specific version will be installed
+
+Note that the system in question must have a `pipx` package available through the default package manager as well as python installed which should come along as a dependency of `pipx`.
diff --git a/software/install-ansible.cf b/software/install-ansible/install-ansible.cf
similarity index 100%
rename from software/install-ansible.cf
rename to software/install-ansible/install-ansible.cf