# 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