Skip to content

docs(deploy): add Arcade Worker page [PLT-3801] - #1218

Merged
josebarrueta merged 8 commits into
mainfrom
jose/plt-3801-docs-add-an-arcade-worker-page-under-operatedeploy-covering
Oct 5, 2026
Merged

josebarrueta merged 8 commits into
mainfrom
jose/plt-3801-docs-add-an-arcade-worker-page-under-operatedeploy-covering

Conversation

@josebarrueta

@josebarrueta josebarrueta commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds operate/deploy/worker, an operator page for the Arcade Worker in self-hosted installs. Resolves PLT-3801.

  • How the worker runs: one image, arcadedev/worker. It runs a supervisor with one isolated runtime per toolkit version, so one worker serves current and older versions. This matches monorepo#4875, which made the supervisor the only worker image; arcadedev/worker-supervisor and the eager image are gone.
  • Upgrading from an earlier chart release: no value changes needed. toolPackages still narrows the served toolkits, and WORKERS no longer has an effect.
  • Behavior operators can rely on: version selection, errors, runtime lifecycle, pre-warm and readiness.
  • Settings under workerDefaults / workers[]: supervisor.prewarmToolkits, serveToolkits, maxChildren, idleTtlSeconds, capacityWaitSeconds, peerRouting.enabled, peerRouting.promoteAfterForwards, toolPackages, plus the advanced extraEnv variables.
  • Sizing: memory per runtime, boot time, CPU.
  • A nav entry in operate/deploy/_meta.tsx, and links from the Helm Configuration section and the architecture page.

The page links to the Artifact Hub chart reference for the full values list.

Test plan

  • vale on the page. One warning remains: "Arcade Worker" heading capitalization, kept as a product name.
  • Settings and defaults checked against deploy/charts/arcade/values.yaml and templates/worker-deployment.yaml on monorepo main.
  • pnpm check-meta (run on the first push; _meta.tsx is unchanged since)
  • Broken-link and internal-link tests (run on the first push; this revision adds only an in-page #sizing link, which already existed)
  • Preview the page and nav in the deploy preview

🤖 Generated with Claude Code

~ 📡 Relay, Jose's Agent


Note

Low Risk
Documentation-only changes with no runtime, auth, or deployment logic touched.

Overview
Adds a new Arcade Worker operator doc at /operate/deploy/worker for self-hosted Helm deployments, covering supervisor behavior, upgrade notes from older chart releases, operator guarantees (versions, errors, lifecycle), Helm settings (workerDefaults / workers[]), sizing, and links to Artifact Hub.

Wires it into the deploy section: nav entry in _meta.tsx, a cross-link from platform architecture (bundled MCP server), a Workers bullet under Helm Configuration, and an entry in public/llms.txt for agent discovery.

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

Explain the worker's two process models (supervisor and eager), the
behavior operators can rely on, the Helm settings under workerDefaults
and workers[], advanced extraEnv variables, and sizing guidance. Link it
from the Helm Configuration section and the architecture page.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 29, 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 5, 2026 7:47pm UTC

Request Review

Remove image.repository, variant, peer routing, and pod sizing values,
and the shard-prewarm variable that depends on peer routing.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
josebarrueta and others added 2 commits September 30, 2026 09:37
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…age [PLT-3801]

Since monorepo#4875 the supervisor is the only worker image, published as
arcadedev/worker; arcadedev/worker-supervisor and the eager image are
gone. Replace the process-model section, add an upgrade note (toolPackages
still narrows the served toolkits, WORKERS no longer applies), document
peer routing and toolPackages, and drop the stale image-size comparison.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@evantahler evantahler left a comment

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.

yay!

…d-an-arcade-worker-page-under-operatedeploy-covering

# Conflicts:
#	public/llms.txt
@josebarrueta
josebarrueta merged commit 2ba3f56 into main Oct 5, 2026
10 of 14 checks passed

This branch was successfully deployed

1 active deployment
Preview — e8ccca59 Deployed Oct 5, 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.

2 participants