Skip to content

Docs: sync upstream clickhouse-operator docs updates#77

Closed
mintlify[bot] wants to merge 1 commit into
mainfrom
sync/clickhouse-operator-docs-2026-05-27
Closed

Docs: sync upstream clickhouse-operator docs updates#77
mintlify[bot] wants to merge 1 commit into
mainfrom
sync/clickhouse-operator-docs-2026-05-27

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 27, 2026

Summary

Syncs the latest docs/ updates from clickhouse/clickhouse-operator into products/kubernetes-operator/.

Changes

  • products/kubernetes-operator/reference/api-reference.mdx — adds the new AdditionalPort type and additionalPorts field on ClickHouseClusterSpec (from upstream #197, cc @GrigoryPervakov).
  • products/kubernetes-operator/guides/configuration.mdx — link path updates.
  • products/kubernetes-operator/guides/introduction.mdx — link path updates.
  • products/kubernetes-operator/install/olm.mdx — minor trailing-newline cleanup.

Context

Upstream PRs picked up in this sync:

⚠️ Known issues (need to be fixed upstream)

Per the sync policy, upstream is copied exactly as-is. The following broken links were introduced because upstream uses bare ClickHouse doc paths, but this Mintlify site mounts those docs under /core/:

In products/kubernetes-operator/guides/configuration.mdx:

  • /concepts/features/configuration/server-config/configuration-files#example-1 → should be /core/concepts/...
  • /reference/settings/server-settings/settings → should be /core/reference/...
  • /concepts/features/configuration/settings/settings-users → should be /core/concepts/...

In products/kubernetes-operator/guides/introduction.mdx:

  • /reference/engines/database-engines/replicated (×2) → should be /core/reference/...

These should be fixed upstream in clickhouse/clickhouse-operator and re-synced. Tagging @GrigoryPervakov and @Blargian for review.


Note

Low Risk
Documentation-only sync with no runtime or security impact; the main caveat is potentially broken internal doc links until paths are corrected.

Overview
Syncs upstream clickhouse-operator docs into products/kubernetes-operator/.

The API reference now documents AdditionalPort and the optional additionalPorts field on ClickHouseClusterSpec, describing extra TCP ports on ClickHouse pods and the operator headless Service (Kubernetes exposure only; ClickHouse listen config is still the operator’s responsibility).

Configuration and introduction guides update cross-links from /core/... paths to shorter /concepts/... and /reference/... URLs (upstream style). On this Mintlify site those paths may not resolve unless prefixed with /core/—fix upstream or adjust on re-sync.

OLM install doc gets a minor trailing-newline change only.

Reviewed by Cursor Bugbot for commit 1582d1b. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 27, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview May 27, 2026, 6:03 PM

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