Newer
Older
openstack-caracal-ipv4 / runbooks / 07-dns-zones.md

Runbook 07 — Designate Zones and Records (v1: A records only)

STATUS: PLACEHOLDER — drafted post-deploy.

Purpose

Create the cloud's DNS zones in Designate, populate API VIP A records (v1: IPv4 only), and configure Neutron defaults to push Designate as tenant DNS resolver.

Prerequisites

  • Designate charm in active/idle
  • Keystone, Neutron API reachable
  • API VIP hostnames already in /etc/hosts on all OpenStack nodes (per D-008 Layer 0 bootstrap)

TODO

  • Create primary zone:
    `openstack zone create --email admin@neumatrix.local \
     omega.dc0.vr0.cloud.neumatrix.local.`
  • Populate API VIP A records for each public service:
    - keystone, glance, nova, neutron, cinder, placement, octavia,
      barbican, magnum, horizon, designate
    - **v1: A records only** (IPv4 VIPs from the Provider API VIP range
      10.12.4.224-.254)
    - **v2 will add AAAA records when IPv6 Provider VIPs become active**
  • Configure Neutron defaults:
    `juju config neutron-api default-dns-domain=omega.dc0.vr0.cloud.neumatrix.local.`
    `juju config neutron-api dns-domain=omega.dc0.vr0.cloud.neumatrix.local.`
  • Configure Neutron DHCP to push Designate as resolver:
    `juju config neutron-api dns-servers=<designate-vip-ipv4>`
  • Verify from a test tenant VM:
    `nslookup keystone.omega.dc0.vr0.cloud.neumatrix.local`
    resolves to Provider API VIP