Skip to content

docs: clarify Global DR network requirements - #969

Merged
chinameok merged 3 commits into
masterfrom
chao/ait-72814-global-dr-network-requirements
Jul 20, 2026
Merged

docs: clarify Global DR network requirements#969
chinameok merged 3 commits into
masterfrom
chao/ait-72814-global-dr-network-requirements

Conversation

@chinameok

@chinameok chinameok commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Added explicit network prerequisites for the Primary and Standby Global Clusters.
  • Documented the purpose of TCP ports 443, optional 80, 6443, 11443, and 2379.
  • Added a direct link from the general LoadBalancer Forwarding Rules to the Global DR Network Requirements section.
  • Clarified that the Standby Cluster uses the platform domain to access platform services on the Primary Cluster.
  • Clarified that both cluster VIPs need the required listeners and that inter-cluster firewall, security-group, routing, and ACL rules must allow the ports in both directions.
  • Used the official plugin name, Alauda Container Platform etcd Synchronizer, in customer-facing descriptions.
  • Clarified that the network policy is bidirectional while etcd synchronization remains one-way from the current Primary to the current Standby.

Why

The platform domain normally resolves only to the Primary Cluster, so steady-state traffic is normally initiated from Standby to Primary. A failover swaps the cluster roles and reverses the required connection direction. The existing documentation listed the ports but did not explain this bidirectional network prerequisite, which could lead to a one-way configuration that fails after switchover. The cross-reference ensures that users configuring general load balancer rules discover the complete Global DR requirements before installation.

Where to backport

This PR targets master only. Do not backport yet. After the master PR is reviewed and merged, backport to applicable release branches only after separate authorization from Chao.

Validation

  • yarn lint docs/en/install: 0 errors, 0 warnings
  • Customer-facing terminology, internal-token, and EN-only checks passed

Review level

Technical correctness and customer-operable Global DR network prerequisites.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 20, 2026

Copy link
Copy Markdown

Deploying alauda-container-platform with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5b77d3a
Status: ✅  Deploy successful!
Preview URL: https://c025bf9c.alauda-container-platform.pages.dev
Branch Preview URL: https://chao-ait-72814-global-dr-net.alauda-container-platform.pages.dev

View logs

@chinameok
chinameok merged commit fe47e36 into master Jul 20, 2026
2 checks passed
@chinameok
chinameok deleted the chao/ait-72814-global-dr-network-requirements branch July 20, 2026 11:13
chinameok added a commit that referenced this pull request Jul 20, 2026
* docs: clarify Global DR network requirements

* docs: use official etcd Synchronizer terminology

* docs: link DR network requirements from prerequisites

---------


(cherry picked from commit fe47e36)

Co-authored-by: Chao Zhou <chaozhou@alauda.io>
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