Skip to content

docs(operator): singleton has no default PDB; recommend node auto-repair - #581

Open
sklarsa wants to merge 2 commits into
mainfrom
docs/operator-singleton-pdb
Open

sklarsa wants to merge 2 commits into
mainfrom
docs/operator-singleton-pdb

Conversation

@sklarsa

@sklarsa sklarsa commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Draft: hold until the operator release that contains questdb/questdb-enterprise-operator#448. Until then the published behaviour is still the old one.

Operator change: a one-instance cluster no longer gets a PodDisruptionBudget by default, so a node drain or node upgrade restarts the database instead of hanging.

  • known-limitations.md: "Singleton drain is blocked by default" becomes "Draining a singleton's node restarts the database".
  • configuration.md: the default PDB applies to replicated clusters only; how to opt a singleton back in.
  • operations/database.md: the node maintenance section is rewritten for the new default.
  • Adds a note recommending node auto-repair for a node that is NotReady while its machine keeps running (the other half of questdb/questdb-enterprise-operator#64).

Before merging:

  • reference/api.md is not touched; it is regenerated from the operator at release and will pick up the new field text then.
  • This overlaps docs(operator): add safe node-pool maintenance runbook #557, which edits the same opening of the node maintenance section in operations/database.md. Whichever merges second needs a rebase.
  • The auto-repair sentence says AKS repairs unhealthy nodes automatically and that EKS needs node auto repair enabled on the managed node group. Worth a check against current cloud docs.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

🚀 Build success!

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

Commit SHA: e429923

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

sklarsa and others added 2 commits October 16, 2026 10:58
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sklarsa
sklarsa force-pushed the docs/operator-singleton-pdb branch from 2bea4c6 to e429923 Compare October 16, 2026 14:58
@sklarsa
sklarsa marked this pull request as ready for review October 16, 2026 14:58
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