Skip to content

docs(dr): reflect the stable floating-IP API endpoint in the DR runbook #2528

Description

@devantler

🤖 Generated by the Daily AI Assistant

Follow-up to #2492 / #2120 (stable floating-IP API endpoint, landed in #2524).

Problem

docs/dr/runbook.md predates the floating-IP endpoint. It states (Scenario 9, and the notes at the top / after Scenario 4) that "after a rebuild the cluster has a new API endpoint" — but with floatingIPEnabled: true the prod API endpoint is now a stable Hetzner floating IP, so at least a control-plane node recreate (the #2120 case) no longer changes it. The runbook should say so, so an operator doesn't needlessly refresh KUBE_CONFIG for an endpoint that didn't move.

Verify before writing (the open question)

Confirm what actually survives which recovery path before editing this critical runbook:

  • CP recreate (single CP replaced): endpoint should now be stable (floating IP re-attaches) — only client certs/PKI unaffected. Likely a new short scenario or a note.
  • Full rebuild (Scenario 4, brand-new cluster): does DR - Rebuild Prod re-attach the same floating IP to the new CPs, or mint a new endpoint? If it re-attaches, KUBE_CONFIG's server URL stays valid and only the Talos PKI changes; if not, Scenario 9 stands as-is.

Acceptance criteria

  • Verify the floating-IP behaviour across CP-recreate vs full-rebuild (check .github/workflows/dr-rebuild.yaml + the floating-IP resource lifecycle).
  • Update the runbook's endpoint-change wording to match, distinguishing the two paths.
  • No speculative claims — only documented, verified behaviour.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    Status
    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions