Kolla-Ansible/Kayobe version enforcement

.ansible-lint-ignore

@@ -5,3 +5,4 @@ etc/kayobe/ansible/vault-generate-internal-tls.yml fqcn[action-core]
 etc/kayobe/ansible/vault-generate-test-external-tls.yml fqcn[action-core]
 etc/kayobe/ansible/rabbitmq-reset.yml command-instead-of-module
 etc/kayobe/ansible/ubuntu-upgrade.yml syntax-check[missing-file]
+etc/kayobe/ansible/check-kayobe-version.yml command-instead-of-module

etc/kayobe/ansible/check-kayobe-version.yml

@@ -0,0 +1,45 @@
+---
+- name: Check kayobe version
+  tags: kayobe-version-check
+  hosts: localhost
+  gather_facts: false
+  vars:
+    requirements_path: "{{ kayobe_config_path }}/../../requirements.txt"
+  tasks:
+    - name: Get installed kayobe commit
+      ansible.builtin.shell:
+        cmd: set -o pipefail && pip freeze | grep kayobe | cut -d @ -f 3
+        executable: /usr/bin/bash
+      register: kayobe_git_commit
+
+    - name: Clone kayobe
+      ansible.builtin.git:
+        repo: https://github.com/stackhpc/kayobe.git
+        dest: /tmp/kayobe-git
+        version: stackhpc/{{ openstack_release }}
+
+    - name: Get tag from kayobe commit
+      ansible.builtin.command:
+        cmd: git describe --tags {{ kayobe_git_commit.stdout }}
+        chdir: /tmp/kayobe-git
+      register: kayobe_current_version
+
+    - name: Get latest Kayobe version
+      ansible.builtin.shell:
+        cmd: set -o pipefail && grep -o kayobe@stackhpc\/.*$ {{ requirements_path }} | cut -d @ -f 2
+        executable: /usr/bin/bash
+      register: kayobe_latest_version
+
+    - name: Check installed kayobe version is the latest
+      ansible.builtin.assert:
+        that: "kayobe_latest_version.stdout in kayobe_current_version.stdout"
+        fail_msg: |
+          Kayobe must be updated to the latest version before continuing.
+
+          Current Kayobe version: {{ kayobe_current_version.stdout }}
+          Latest Kayobe version: {{ kayobe_latest_version.stdout }}
+
+          Recreate the Kayobe environment, or install the latest version
+          by running: pip install --force-reinstall -r {{ requirements_path }}
+        success_msg: |
+          Kayobe running at version: {{ kayobe_current_version.stdout }}

etc/kayobe/hooks/control-host-bootstrap/pre.d/check-kayobe-version.yml

@@ -0,0 +1 @@
+../../../ansible/check-kayobe-version.yml

etc/kayobe/hooks/overcloud-host-configure/pre.d/check-kayobe-version.yml

@@ -0,0 +1 @@
+../../../ansible/check-kayobe-version.yml

etc/kayobe/hooks/overcloud-service-deploy/pre.d/check-kayobe-version.yml

@@ -0,0 +1 @@
+../../../ansible/check-kayobe-version.yml

etc/kayobe/hooks/overcloud-service-upgrade/pre.d/check-kayobe-version.yml

@@ -0,0 +1 @@
+../../../ansible/check-kayobe-version.yml

releasenotes/notes/check-kayobe-version-f44d43c9c34d1b89.yaml

@@ -0,0 +1,6 @@
+---
+features:
+  - |
+    Ansible playbook to check the installed Kayobe version against
+    the version defined in Kayobe configuration. This playbook will
+    run on Kayobe bootstrap, host and service operations.