Runbook 05 — Magnum CAPI Helm Driver Graft

STATUS: PLACEHOLDER — drafted post-deploy. Per D-007 Layer B.

Purpose

Install the stackhpc/magnum-capi-helm driver into the magnum charm venv, configure Magnum to use it, and verify cluster-template creation succeeds.

Prerequisites

• Runbook 04 complete (magnum domain setup done)
• capi-mgmt.maas k3s cluster healthy (CAPI/CAPO/cert-manager/ORC pods Running)
• Per D-007 Layer B, kubeconfig from capi-mgmt.maas accessible

TODO

• juju ssh magnum/leader and `pip install --break-system-packages \

  "git+https://github.com/stackhpc/magnum-capi-helm@v0.13.0"`
  into the charm venv

• Place /etc/magnum/kubeconfig pointing at capi-mgmt.maas bootstrap k3s
• Systemd override for magnum services to load --config-dir /etc/magnum/magnum.conf.d/
• Create /etc/magnum/magnum.conf.d/99-capi.conf:

  ```
  [DEFAULT]
  enabled_drivers = k8s_capi_helm_v1
  
  [capi_helm]
  kubeconfig_file = /etc/magnum/kubeconfig
  ```

• Restart magnum-api and magnum-conductor
• Verify driver loaded: openstack coe cluster template list

  should show capi_helm_v1 driver option available

• Smoke test: create a test cluster template + 1-node cluster;

  verify it reaches CREATE_COMPLETE