Documentation

Author: assumptionsandg

doc/source/configuration/index.rst

@@ -21,3 +21,4 @@ the various features provided.
    magnum-capi
    ci-cd
    cloudkitty
+   ipa

doc/source/configuration/ipa.rst

@@ -0,0 +1,34 @@
+.. _ipa:
+
+=========================
+Ironic Python Agent (IPA)
+=========================
+
+Release Train IPA
+=================
+
+StackHPC provides built Ironic Python Agent (IPA) images in Release Train
+through Ark.
+
+These images are built in a CI using a Kayobe workflow :kayobe-doc:
+`Kayobe documentation <configuration/reference/ironic-python-agent.html>`
+and are configured in this repository.
+
+Release Train IPA is used by Bifrost and Overcloud Ironic by default in
+StackHPC Kayobe Configuration, and is pulled in to Inspector when running
+``kayobe seed service deploy`` for Bifrost or ``kayobe overcloud post configure``
+for Ironic. This behaviour can be disabled in `stackhpc-ipa-images.yml`:
+
+.. code-block:: yaml
+
+    stackhpc_ipa_image_bifrost_enabled: false
+    stackhpc_ipa_image_overcloud_enabled: false
+
+You can also override the distribution version pulled in during deployment,
+to do this you can change ``stackhpc_ipa_image_version`` to be the opposite
+distribution. For example, the case of switching to Ubuntu 22.04 on a Rocky 9
+cloud:
+
+.. code-block:: yaml
+
+    stackhpc_ipa_image_version: "{{ stackhpc_ubuntu_jammy_ipa_image_version }}"

etc/kayobe/environments/ci-builder/inventory/hosts

@@ -3,6 +3,7 @@
 [ofed-builder:children]
 seed
 
+# This is neccesary to run `overcloud deployment image build`
 [controllers]
 builder
 

releasenotes/notes/ipa-build-workflow-cde24f3b9e3e0667.yaml

@@ -0,0 +1,6 @@
+---
+features:
+  - |
+    Adds a new build workflow to Release Train for building IPA
+    images, and deployment for Release Train IPA images to Bifrost
+    and Ironic inspector.