Fork: 0
OpenStack / openstack-caracal-ipv4
Download ZIP 34 commits
Transfer to URL with SHA
openstack-caracal-ipv4 / runbooks /
..
README.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
appendix-A-troubleshooting.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
appendix-B-asbuilt-version-lock.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-00-teardown-maas-reset.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-01-bundle-deploy.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-02-vault-bringup.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-03-core-verify.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-04-network-carve.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-05-octavia-enablement.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-06-incloud-mgmt-cluster.md Updated runbook 1 day ago
phase-07-conductor-graft.md repo: sanitation sweep -- canonical phase-NN runbook + appendices; design-decisions D-001..D-042; canonical bundle; superseded files moved to remove/ for review 1 day ago
phase-08-workload-cluster-acceptance.md Runbook updates 1 day ago
v1-ops-capi-recovery-procedure-20260610.md Runbook folder updates 21 hours ago
README.md

v1 Deploy Runbook -- VR0 DC0 Omega Cloud (Caracal 2024.1, IPv4)

The deploy is a gated sequence: run phase-00 through phase-08 in order. Each phase ends in a hard gate (an explicit pass/fail check); do not start the next phase until the current gate passes. The two appendices are reference, not steps.

Conventions

  • RUN location. Every command block is tagged with where it runs: # RUN: jumphost (the vopenstack-jesse jumphost, with juju + the openstack CLI), # RUN: mgmt VM (the in-cloud CAPI management VM, reached over SSH), or a charm unit via juju ssh <unit> -- '...' </dev/null.
  • Gates. A line beginning GATE: or EXIT GATE is a stop-and-verify. Read-only verification precedes every mutation; destructive and secret-handling steps are individually gated, never batched.
  • Dynamic lookups. VIPs, project names, IDs, and version constellations are discovered at run time, not hardcoded. Site-specific literals are tagged ENV(...) for the eventual generalization pass toward Roosevelt.
  • ASCII only. All runbook content is ASCII (a mod_wsgi UnicodeDecodeError lesson); keep it that way on edit.

Phases

# File Purpose Decisions
00 phase-00-teardown-maas-reset.md Destroy the model + reset MAAS to a clean rebuild KI-P3-001
01 phase-01-bundle-deploy.md Octavia PKI overlay + juju deploy + settle wait
02 phase-02-vault-bringup.md Vault init/unseal + cert cascade (PKI root) manual unseal = v1 std
03 phase-03-core-verify.md Settle, regenerate admin-openrc, verify Horizon
04 phase-04-network-carve.md Provider external network + IPAM reference
05 phase-05-octavia-enablement.md Enable Octavia (amphora) D-021
06 phase-06-incloud-mgmt-cluster.md In-cloud single-homed CAPI management cluster D-035
07 phase-07-conductor-graft.md Graft the magnum-capi-helm driver onto the conductor D-031 / D-037 / D-042
08 phase-08-workload-cluster-acceptance.md End-to-end tenant cluster + acceptance bar D-011 (amended D-019)

Appendices

  • appendix-A-troubleshooting.md -- symptom -> cause -> fix index, keyed by D-NNN / DOCFIX-NNN / lesson.
  • appendix-B-asbuilt-version-lock.md -- charm channels, the CAPI version constellation, and the magnum-capi-helm driver pin.

History

This phase-NN set supersedes the earlier v1-do-doc-NN-* execution documents (and the older NN-*.md set and the deprecated/ folder), which were removed in the repo sanitation sweep. Git history preserves them.