Skip to content

docs(operator): add safe node-pool maintenance runbook - #557

Draft
sklarsa wants to merge 1 commit into
mainfrom
docs/operator-node-pool-maintenance
Draft

sklarsa wants to merge 1 commit into
mainfrom
docs/operator-node-pool-maintenance

Conversation

@sklarsa

@sklarsa sklarsa commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

What

Documents a complete add-before-remove node-pool maintenance workflow for replicated QuestDB clusters:

  • cordon retiring Nodes before adding capacity;
  • add and validate one surge replica;
  • handle a primary through planned promotion;
  • drain one Node at a time under the default PDB;
  • wait for the original Pod/PVC identity to re-home and recover; and
  • restore the steady instance count and handle the temporary PVC.

It also documents the default hostname/zone placement behavior, scheduling overrides, same-zone capacity requirements, and safe stop/recovery points.

Why

The existing instances API already supports safe node-pool rotation through scale out → drain → scale in. A proposed spec.rotation.retire API in questdb/questdb-enterprise-operator#346 had no controller behavior and duplicated this workflow, so that PR was closed in favor of documenting the supported procedure.

Verification

  • yarn build
  • git diff --check

@github-actions

Copy link
Copy Markdown

🚀 Build success!

Latest successful preview: https://preview-557--questdb-documentation.netlify.app/docs/

Commit SHA: b6830e2

📦 Build generates a preview & updates the link on each commit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant