Skip to content

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

Open
sklarsa wants to merge 1 commit into
docs/operator-singleton-pdbfrom
docs/operator-node-pool-maintenance
Open

sklarsa wants to merge 1 commit into
docs/operator-singleton-pdbfrom
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

github-actions Bot commented Sep 17, 2026 •

Copy link
Copy Markdown

🚀 Build success!

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

Commit SHA: a76d4ad

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

@sklarsa
sklarsa force-pushed the docs/operator-node-pool-maintenance branch from b6830e2 to a76d4ad Compare October 16, 2026 15:24
@sklarsa
sklarsa changed the base branch from main to docs/operator-singleton-pdb October 16, 2026 15:24
@sklarsa
sklarsa marked this pull request as ready for review October 16, 2026 17:14
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