Skip to content

docs(helm): internal networking, IPv6/dual-stack and container registry guides [DEP-371] - #1241

Open
pmdroid wants to merge 5 commits into
mainfrom
pascal/dep-371-batch-1
Open

pmdroid wants to merge 5 commits into
mainfrom
pascal/dep-371-batch-1

Conversation

@pmdroid

@pmdroid pmdroid commented Oct 12, 2026 •

Copy link
Copy Markdown
Member

Adds three use-case guides under Self-host with Helm (Sterling's split from #1237), as child pages of /operate/deploy/helm:

Page Covers
/operate/deploy/helm/internal-networking No public ingress; internal Gateway (gateway.parentRefs, per-service gateway.<service>.parentRefs) or private Ingress class; engine.ssrfAllowlist / authSsrfAllowlist / pluginSsrfAllowlist; coordinator.proxyHeaders.forwardedAllowIps
/operate/deploy/helm/ipv6-dual-stack global.bindAddress, global.ipFamilyPolicy, global.ipFamilies, and which components and Services each covers; explicit list of what is still IPv4-only (Arcade Deploy default egress, external DNS nameservers, deployed-server Services). IPv6-only is not supported.
/operate/deploy/helm/container-registry Mirrors and air-gapped installs; per-image repositories, supportImages.*, dockerRegistry.* (and that bundled PostgreSQL/Redis get no pull Secret), Arcade Deploy runner image (deployments.image, deployments.registry.server, deployments.registry.imagePullSecrets)

Each page has: when you need it, a values overlay, how to verify, common failures, and what you own vs what the chart handles. Every value name was checked against deploy/charts/arcade/values.yaml on monorepo main.

Follow-up: once this merges, #1237 replaces its IPv6/use-case TODO with links to these pages (it can't link earlier: the broken-link test rejects links to unmerged pages).

Review fixes

  • Codex P3 is fixed in bc3bbc2. The IPv6 page now lists the Services that ipFamilyPolicy and ipFamilies apply to: Engine, coordinator, dashboard, Experience API, OpenFGA, worker and worker-peers. It also notes that bundled PostgreSQL, Redis and subcharts are not covered, and adds worker-peers to the list at line 33.

Proof @ bc3bbc2

  • Codex autoreview: gpt-6.1-sol, 1 finding at P2+ at 074b5f6, now fixed; not re-run for this two-line wording fix
  • Closeout: not run (ENV GAP: closeout CLI not available)
  • CI: 8 passed / 0 failed / 0 pending of 9 (reindex skipped)

Note

Low Risk
Documentation-only changes with no runtime or application code; risk is limited to doc accuracy and navigation.

Overview
Adds three Self-host with Helm child guides and wires them into the docs site via app/en/operate/deploy/helm/_meta.tsx.

Internal networking documents private-only exposure (Gateway API HTTPRoutes with gateway.parentRefs / per-service overrides, or legacy private Ingress), SSRF allowlists (engine.ssrfAllowlist, authSsrfAllowlist, pluginSsrfAllowlist), coordinator forwarded-header trust, and troubleshooting—including AWS TargetGroupConfiguration behavior on non-AWS clusters.

IPv6 and dual-stack covers global.bindAddress, global.ipFamilyPolicy, and global.ipFamilies, verification steps, and explicit IPv4-only gaps (especially Arcade Deploy egress, DNS, and deployed-server Services).

Use a different container registry explains mirroring per-component image repos, dockerRegistry / supportImages, bundled Postgres/Redis pull limitations, Arcade Deploy runner pull secrets in the workers namespace, air-gapped install steps, and common ImagePullBackOff failures.

public/llms.txt is regenerated with entries for the three new pages.

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

@vercel

vercel Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 13, 2026 10:14pm UTC

Request Review

- Your network policy requires Services to expose both an IPv4 and an IPv6 ClusterIP.

## Values overlay

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this section jumps straight to the code snippet without giving any context. will users know what to do with this?

This branch was successfully deployed

1 active deployment
Preview — bc3bbc2c Deployed Oct 13, 2026 by vercel[bot]
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.

3 participants