发布

  • [OPIK-7332] [HELM][DOCS] fix: two-phase HA guidance for multi-replica ClickHouse installs (#7530)

    frostbyte_neo 发布于 2026-07-20 12:37:07 +00:00

    • [OPIK-7332] [HELM][DOCS] fix: two-phase HA guidance for multi-replica ClickHouse installs

    • docs(self-host): format two-phase install as Fern Steps components

    Address PR review (Baz): the migrate-then-scale procedure was raw Markdown
    1./2./3. lists; wrap it in Fern / per the write-docs convention.
    Applied to both the scaling and troubleshooting pages across the v1 and v2 docs.

    • test(helm): cover explicit single-replica NOTES case (PR review)

    Address PR review (JetoPistola): add an explicit clickhouse.replicasCount: 1
    test for the conditional's lower boundary (robust to a future default change),
    and keep the no-override test — renamed to "default replica count" — as a canary
    that the shipped default stays single-replica and keeps the banner off.

    • docs(self-host): clarify configurable DB name and greenfield ZK recovery (PR review)

    Address PR review (Baz):

    • Note that opik is the default analytics database name
      (ANALYTICS_DB_DATABASE_NAME) and may be overridden, mirroring the existing
      ZooKeeper-recovery note on the same page.
    • Reword the REPLICA_ALREADY_EXISTS warning: a fresh install has no data to
      preserve, so recovery only needs the orphaned ZooKeeper paths cleared — the
      full replica-restore rebuild in the linked section is for existing data and
      isn't needed here (avoids pointing greenfield operators at a destructive
      data-restoration procedure).

    下载附件