Shorten Postgres rename help to the hostname change and connection-string update
cloud postgres update --help currently says --new-name changes the hostname and certificates, then asserts that "pinned CAs break" and directs users to fetch certificates again. Keep the useful hostname warning, but remove the unsupported CA-invalidation claim.
Proposed help
Under the existing CONTEXT FOR AGENTS: block:
--new-name changes the service hostname; re-read `cloud postgres get` and update connection strings.
This is a non-obvious consequence of renaming and gives the next action needed to reconnect. It belongs on the update command. No certificate-management explanation is needed in this short help block.
Historical basis
Live evidence
On main df81e46cfec0bb58ea981d17cc6fd2de24442e7d (0.5.0), the September 23 disposable-service QA run saved the CA, renamed the service, and connected to its new hostname using the original CA. The first attempt failed hostname verification; a retry ten seconds later succeeded with verified TLS and the expected data. The CA bundles fetched before and after rename had identical SHA256 hashes.
This disproves the unconditional "pinned CAs break" claim. It does not establish that CAs can never change or guarantee a propagation interval. The proposed help makes neither claim.
Acceptance
- Replace the existing two-line rename/certificate warning in
crates/clickhousectl/src/cloud/postgres.rs with the short hostname/action guidance above.
- Remove the unconditional CA-breakage claim and the associated instruction to fetch certificates again.
- Keep this a help-only correction. Check the rendered help and existing structural help checks; do not add tests that pin the sentence verbatim.
Searched existing open and closed issues for Postgres rename and pinned-CA guidance; the earlier rename-capability issues do not cover this wording correction.
Shorten Postgres rename help to the hostname change and connection-string update
cloud postgres update --helpcurrently says--new-namechanges the hostname and certificates, then asserts that "pinned CAs break" and directs users to fetch certificates again. Keep the useful hostname warning, but remove the unsupported CA-invalidation claim.Proposed help
Under the existing
CONTEXT FOR AGENTS:block:This is a non-obvious consequence of renaming and gives the next action needed to reconnect. It belongs on the update command. No certificate-management explanation is needed in this short help block.
Historical basis
--nametocloud postgres updatefor parity withservice update#668, fixingcloud postgres updatecannot rename a service: no--nameflag, though the API PATCH acceptsname#663.--new-name; it retained the CA assertion.Live evidence
On main
df81e46cfec0bb58ea981d17cc6fd2de24442e7d(0.5.0), the September 23 disposable-service QA run saved the CA, renamed the service, and connected to its new hostname using the original CA. The first attempt failed hostname verification; a retry ten seconds later succeeded with verified TLS and the expected data. The CA bundles fetched before and after rename had identical SHA256 hashes.This disproves the unconditional "pinned CAs break" claim. It does not establish that CAs can never change or guarantee a propagation interval. The proposed help makes neither claim.
Acceptance
crates/clickhousectl/src/cloud/postgres.rswith the short hostname/action guidance above.Searched existing open and closed issues for Postgres rename and pinned-CA guidance; the earlier rename-capability issues do not cover this wording correction.