Skip to content

Enterprise clustering and HA claims on the deploy pages exceed what the objectos-ee kit ships (Redis cluster driver, OS_CLUSTER_REPLICAS, "high availability") #443

Closed

Description

@objectstack-fleet

repo:cloud#1 · os-bob · session_012dn2AdARJtc4RgABPH7PHk

Filing gate: ① a user-visible misleading statement with a named location, found by the docs#350 dev (os-dev-report on #350, out_of_scope_findings class a and class b), measured against objectstack-ai/cloud main 9e71fd6a.

Reader: the repo:cloud lane (it carries Enterprise docs under the maintainer's 「cloud 相关的任务,转 cloud 车道处理」).

Dedupe (this repository, open and closed): cluster driver Redis → 1 hit (#350, the source); high availability HA → 1 hit (#350).

维护者速读

文档站有两处对企业版的承诺超出了安装包实际能做的:部署页叫运维开启 Redis 集群驱动并设置副本数,但企业版安装包现在根本没有接集群驱动,副本数设成大于 1 会直接拒绝启动;另外两页写了「集群与高可用」,而 cloud 的功能目录明确写着「不得承诺 HA」。客户照文档做会启动失败,或者被承诺了没有的能力。

Where

  1. content/docs/deploy/docker.mdx § "Multi-node on Enterprise" (/docs/deploy/docker#multi-node-on-enterprise): tells Enterprise operators to turn on the Redis cluster driver and set OS_CLUSTER_REPLICAS. The EE kit's README (cloud apps/objectos-ee/deploy/README.md:107-137) says no cluster driver is wired today and OS_CLUSTER_REPLICAS above 1 refuses the boot.
  2. content/docs/deploy/index.mdx (the editions table: "clustering and high availability") and content/docs/editions/license.mdx ("Clustering / HA"): cloud docs/design/ee-feature-catalog.md:42 says "Do NOT promise HA included".

Expected

  • The pages state what the kit does today (single node; multi-node as the catalog allows it, with the boot refusal above 1 replica until a driver ships) and promise nothing the catalog forbids. English only; locale siblings per AGENTS.md (a reversed capability assertion deletes them in the same PR).
  • Every claim cites the cloud path it rests on in the PR body.

Priority: p1 (a documented operator step that refuses to boot; an external promise the catalog forbids).

Activity

  1. objectstack-fleet commented on Nov 7, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:cloud#1 · os-bob · session_012dn2AdARJtc4RgABPH7PHk

    Claim · 2026-11-07T17:50Z

    Claim: PM loop round R49
    Session: session_012dn2AdARJtc4RgABPH7PHk
    Account: os-bob
    Branch: claude/issue-443-ee-cluster-ha-claims
    Worktree: /home/user/w12/docs-issue-443
    Domain: domain:docs (carried by the repo:cloud lane)
    Seat: repo:cloud#1
    File surface: content/docs/deploy/docker.mdx (§ Multi-node on Enterprise), content/docs/deploy/index.mdx (editions table), content/docs/editions/license.mdx (Clustering / HA), and the locale siblings of any page whose capability assertion is reversed (deleted, per AGENTS.md). Stop on breach.
    Container & model: S, mode:subagent, model: TIER_DEFAULT, effort: medium
    Clause-②: no
    Metadata-protocol: none
    Responsibility: the statements are this site's; the facts are cloud's (apps/objectos-ee/deploy/README.md:107-137, docs/design/ee-feature-catalog.md:42 on cloud main).
    Thread-read: none
    Premise: holds (measured by the docs#350 dev against cloud main 9e71fd6a).
    Serial constraints cleared: docs PR #442 (this seat) adds deploy/licensing.mdx and deploy/multi-organization.mdx and edits deploy/meta.json — no file overlap with this surface.

  2. objectstack-fleet commented on Nov 7, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:cloud#1 · os-bob · session_012dn2AdARJtc4RgABPH7PHk
    os-dev-report

    {"issue":443,"status":"done","branch":"claude/issue-443-ee-cluster-ha-claims","pr":"https://github.com/objectstack-ai/docs.objectos.ai/pull/444","session":"session_012dn2AdARJtc4RgABPH7PHk","premise_still_valid":true,"summary":"Rewrote docs.objectos.ai deploy/docker.mdx 'Multi-node on Enterprise' to state single node today, OS_CLUSTER_REPLICAS>1 refuses boot, no HA promise, multi-node by license contract; reworded the editions-table, license.mdx and Community-paragraph clustering/HA claims. Deleted ja/zh-Hans/zh-Hant siblings of the three pages (capability assertion reversed).","tests":"install, type-check --force, check-translation-ownership, check-translations, gen:zh-hant --check, build --force all exit 0","gates":"local: those six, exit codes captured to files; CI check-runs not yet read (in_progress)","dogfood_battery":"n/a","mcp_calls":"0","api_writes":"2 (relay pr_create objectstack-ai/docs.objectos.ai#444 with assignee os-bob; this os-dev-report comment)","open_questions":[],"security_findings":"withheld","out_of_scope_findings":["class: b · reach: public page content/docs/editions/compare.mdx:38 row 'Clustering / high availability' under Enterprise, vs cloud docs/design/ee-feature-catalog.md:42 'Do NOT promise HA included' · evidence: grep; kubernetes.mdx and air-gapped.mdx also mention clustering, unread · dedupe words: compare clustering high availability Enterprise row; carrier: none"]}
  3. objectstack-fleet commented on Nov 7, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:cloud#1 · os-bob · session_012dn2AdARJtc4RgABPH7PHk

    os-dev-report addendum (PR #444, head 567bf10, seat order to extend the surface)

    • Also changed: editions/compare.mdx (Enterprise row and the single-node paragraph), deploy/kubernetes.mdx (description, "Multi-replica" pointer, "Every replica gets identical secrets": no longer says to turn on a Redis cluster driver; says one replica today, boot refusal above 1, license-activated multi-node, no HA promise), deploy/air-gapped.mdx ("and Redis, when clustered" dropped). Locale siblings of those three pages deleted (ja, zh-Hans, zh-Hant).
    • Boot-refusal code cited: objectstack-ai/objectstack packages/services/service-cluster/src/split-brain-guard.ts on main: declaresMultiNode (OS_EXPECT_MULTI_NODE or OS_CLUSTER_REPLICAS greater than 1, line 64) and assertClusterDriverSafeForTopology throwing "ClusterServicePlugin: multi-node deployment declared ... cluster driver is in-process memory" (lines 78-88). Cloud-side claims still rest on apps/objectos-ee/deploy/README.md:107-137 and docs/design/ee-feature-catalog.md:42. The PR body was not edited (dev writes it once); this comment carries the added citations.
    • Gates at 567bf10, all exit 0: install --frozen-lockfile, type-check --force, check-translation-ownership, check-translations, gen:zh-hant --check, build --force.
  4. objectstack-fleet commented on Nov 7, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:cloud#1 · os-bob · session_012dn2AdARJtc4RgABPH7PHk

    LANDED · 2026-11-07T18:09Z

    probe reading
    PR #444 merged: true, merge commit c0e180150
    deploy docs CI push run: Publish the tested Worker success, Smoke-check the live site success, rollback skipped
    live page https://docs.objectos.ai/docs/deploy/docker serves "refuses the boot"
    this card closed / completed by Fixes #443
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions