Reworked "upgrades" section of the Managed Postgres docs for Beta#6283
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
4 Skipped Deployments
|
|
|
|
Docs PR opened: ClickHouse/mintlify-docs-dev#64 Reworked the Managed Postgres upgrades page with a broader maintenance updates section, default maintenance window, and updated major version guidance. |
amogiska
approved these changes
May 26, 2026
achudnovskij
force-pushed
the
andreyc/update-docs
branch
from
6c0114b to
e007fe0
Compare
Copilot stopped reviewing on behalf of
achudnovskij due to an error
May 26, 2026 20:14
dhtclk
approved these changes
May 26, 2026
Collaborator
dhtclk
left a comment
dhtclk
left a comment
There was a problem hiding this comment.
Approving as to not block, but left some nits as I noticed some grammatical errors.
| ## Major version upgrades {#major-version-upgrades} | ||
|
|
||
| Major version upgrades (e.g., 17.x to 18.x) via UI and API is coming soon. | ||
| In the meantime, contact [support](https://clickhouse.com/support/program) to set up a maintenance window for your instance. No newline at end of file |
Collaborator
There was a problem hiding this comment.
Just double checking because this looks like it may be copy/pasted line from above, is this intentional?
Contributor
Author
There was a problem hiding this comment.
No, thanks for noticing, fixind
|
|
||
| For instances with [standbys](/cloud/managed-postgres/high-availability) enabled, the upgrade is applied to the standby first, followed by a failover to minimize downtime. | ||
| - Minor version upgrades (e.g., 17.4 to 17.5) include bug fixes and PostgreSQL engine security patches. | ||
| - Managed Service features. Improvements to native CDC, observability, pg_clickhouse, and other extensions. |
Collaborator
There was a problem hiding this comment.
Suggested change
| - Managed Service features. Improvements to native CDC, observability, pg_clickhouse, and other extensions. | |
| - Managed Service improvements, including native CDC, observability, pg_clickhouse, and other extensions. |
| For instances with [standbys](/cloud/managed-postgres/high-availability) enabled, the upgrade is applied to the standby first, followed by a failover to minimize downtime. | ||
| - Minor version upgrades (e.g., 17.4 to 17.5) include bug fixes and PostgreSQL engine security patches. | ||
| - Managed Service features. Improvements to native CDC, observability, pg_clickhouse, and other extensions. | ||
| - Operating system and system components patches. Including security fixes, efficiency, and other improvements. |
Collaborator
There was a problem hiding this comment.
Suggested change
| - Operating system and system components patches. Including security fixes, efficiency, and other improvements. | |
| - Operating system and system component patches, including security fixes, efficiency improvements, and other enhancements. |
Co-authored-by: Dominic Tran <dominic.tran@clickhouse.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Reworked "upgrades" section of the Managed Postgres docs for Beta
Checklist
Note
Low Risk
Documentation-only changes to the upgrades guide with no application or infrastructure code impact.
Overview
Restructures the Managed Postgres upgrades guide for beta by replacing the old minor version upgrades section with a broader maintenance updates section that covers minor PG bumps, managed-service feature rollouts, and OS/system patches, still described as failover-based with brief downtime and standby-first behavior.
Documents a default maintenance window (Sunday 14:00–16:00 UTC, under 1 minute expected downtime) and limits custom maintenance windows to Enterprise tier, noting upcoming UI/API while support handles setup today.
Moves major version upgrades to the end of the page: examples updated to 17.x→18.x, UI/API marked coming soon, and upgrades directed to support instead of implying the same automatic failover flow as maintenance.
Reviewed by Cursor Bugbot for commit 6f3de52. Bugbot is set up for automated code reviews on this repo. Configure here.