Add docs for ci-tenks environment

Author: Alex-Welsh

doc/source/contributor/environments/ci-tenks.rst

@@ -0,0 +1,76 @@
+==========
+ci-tenks
+==========
+
+The ``ci-tenks`` Kayobe environment is used to test Seed services.
+It is is currently a work in
+progress.
+
+The environment is deployed using `automated-deployment.sh`. It bootstraps
+localhost as a hypervisor for a seed and one controller instance. The Seed
+provisions controller with Bifrost.
+
+It currently tests:
+
+* Seed Hypervisor host configuration
+* Seed VM provisioning
+* Seed host configuration
+* Pulp deployment
+* Pulp container syncing (one container - Bifrost)
+* Bifrost Overcloud provisioning
+
+In the future it could test:
+
+* Pulp package syncing
+* Overcloud host configuration, pulling packages from a local pulp
+* Upgrades (Host OS and OpenStack)
+* Multi-node OpenStack deployments
+
+   * Multiple Controllers
+   * Multiple Compute nodes (and live migration)
+   * Multiple Storage nodes (Ceph)
+
+These extensions depend on more SMS hypervisor capacity and improved sync times
+for the local Pulp instance.
+
+Prerequisites
+=============
+
+* A Rocky Linux 9 or Ubuntu Noble 24.04 host
+* 16GB of memory
+* 4 cores
+* No LVM
+
+Setup
+=====
+
+The environment is designed to run in CI, however can also be deployed
+manually.
+
+Access the host via SSH. You may wish to start a ``tmux`` session.
+
+Download the setup script:
+
+.. parsed-literal::
+
+   curl -LO https://raw.githubusercontent.com/stackhpc/stackhpc-kayobe-config/stackhpc/2025.1/etc/kayobe/environments/ci-tenks/automated-deployment.sh
+
+Change the permissions on the script:
+
+.. parsed-literal::
+
+   sudo chmod +x automated-deployment.sh
+
+Acquire the Ansible Vault password for this repository, and store a
+copy at ``~/vault-pw``.
+
+.. note::
+
+   The vault password is currently the same as for the ``ci-aio``
+   environment.
+
+Run the setup script:
+
+.. parsed-literal::
+
+   ./automated-deployment.sh

doc/source/contributor/environments/index.rst

@@ -9,4 +9,5 @@ The following Kayobe environments are provided with this configuration:
    ci-aio
    ci-builder
    ci-multinode
+   ci-tenks
    aufn-ceph

etc/kayobe/environments/ci-tenks/README.md

@@ -0,0 +1,36 @@
+# CI-Tenks Kayobe Environment
+
+This Kayobe environment is designed for use in CI, primarily to test Seed
+service deployment and Bifrost provisioning. It is currently a work in
+progress.
+
+The environment is deployed using the `automated-deployment.sh` script. This
+script bootstraps the localhost as a hypervisor for a Seed and one Controller
+instance. The Seed provisions the Controller using Bifrost.
+
+### Current Tests
+
+The environment currently tests the following:
+
+* Seed Hypervisor host configuration
+* Seed VM provisioning
+* Seed host configuration
+* Pulp deployment
+* Pulp container syncing (one container - Bifrost)
+* Bifrost Overcloud provisioning
+
+### Future Enhancements
+
+Potential future tests include:
+
+* Pulp package syncing
+* Overcloud host configuration, pulling packages from a local Pulp instance
+* Full openstack service deployment (AIO or otherwise)
+* Upgrades (Host OS and OpenStack)
+* Multi-node OpenStack deployments:
+  * Multiple Controllers
+  * Multiple Compute nodes (including live migration)
+  * Multiple Storage nodes (e.g., Ceph)
+
+These enhancements depend on increased SMS hypervisor capacity and improved
+synchronization times for the local Pulp instance.