Runbooks¶

Proven, repeatable procedures for operating OpsDev.nz infrastructure and tooling.

DNS as Code¶

Manage DNS records as code using OctoDNS and the Metaname provider. All changes flow through Git — review plans in merge requests, apply with manual approval.

• Workflow — step-by-step DNS change process
• Secret Resolution — how 1Password secrets flow through the provider
• Testing Guide — exercise the provider without live credentials

Docs as Code¶

Publish module documentation through GitHub Pages with custom domains using DNS-as-Code and Zensical.

• GitHub Pages Setup — set up a GitHub Pages site for a module

OpenCollective Collectives¶

Launch and operate OpenCollective collectives under the StartMeUp.NZ fiscal host using oc-opsdevnz.

• Collective Setup — Staging — runbook for creating a collective, applying to a host, and creating projects under it.
• Collective Setup — Production — promote a signed-off collective from staging to production.

Secrets Management¶

Coming soon — managing 1Password service accounts, vaults, and automated credential rotation.