Skip to content

Commit bbdbc15

Browse files
josebarruetaclaude
andcommitted
docs(deploy): drop runbook-only worker settings [PLT-3801]
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>
1 parent e30d723 commit bbdbc15

2 files changed

Lines changed: 2 additions & 12 deletions

File tree

‎app/en/operate/deploy/helm/page.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Once the pods are running, open your configured hostname and sign in through you
6060
Configure the platform through Helm values. The chart covers:
6161

6262
- **Components** — the [platform services](/operate/deploy/architecture) and how many replicas of each to run
63-
- **Workers** — the [Arcade Worker](/operate/deploy/worker) image, which toolkits each worker serves and keeps warm, and how many runtimes it runs at once
63+
- **Workers** — which toolkits each [Arcade Worker](/operate/deploy/worker) serves and keeps warm, and how many runtimes it runs at once
6464
- **Identity** — your OIDC identity provider and [OAuth providers](/references/auth-providers)
6565
- **Data stores** — bundled or external PostgreSQL and Redis
6666
- **Networking** — ingress or Gateway API, TLS, and the `engine.ssrfAllowlist` for reaching internal services

‎app/en/operate/deploy/worker/page.mdx‎

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,7 @@ The worker ships as two images built from the same commit. The image you choose
1616
| Image | Process model |
1717
| --- | --- |
1818
| `arcadedev/worker-supervisor` | Serves the tool catalog from a snapshot taken at build time, and starts one isolated runtime per toolkit version on demand. One worker can host multiple versions of the same toolkit. |
19-
| `arcadedev/worker` | Eager: loads every toolkit into one process at boot. Use it to roll back. |
20-
21-
To switch, set `image.repository` to the other image. You don't need to rebuild anything or change any other value.
19+
| `arcadedev/worker` | Eager: loads every toolkit into one process at boot. |
2220

2321
## How the supervisor worker behaves
2422

@@ -50,24 +48,18 @@ Set these values under `workerDefaults` to apply them to every worker, or on an
5048

5149
| Value | Default | What it controls and when to change it |
5250
| --- | --- | --- |
53-
| `image.repository` | See the [chart reference](https://artifacthub.io/packages/helm/arcade/arcade) | Which [process model](#process-models) the worker runs. Point it at `arcadedev/worker` to roll back. |
54-
| `variant` | Derived from the image | `supervisor` or `eager`. Set it only when you mirror the images under other names, so telemetry (`worker_variant`) and supervisor-only resources render correctly. |
5551
| `supervisor.prewarmToolkits` | Empty | Toolkits started at boot and kept warm, at the highest version of each. Pre-warmed toolkits are exempt from idle eviction and restart if they die. List the toolkits your users call most, so they're never served cold. |
5652
| `supervisor.serveToolkits` | `*` | Toolkits this worker serves. The worker refuses calls for anything left off and leaves it out of the published tools. Use it to split a fleet, for example to run a dedicated worker for the most-called toolkits. |
5753
| `supervisor.maxChildren` | `15` | The most runtimes running at once. At the cap, the worker stops the least recently used idle runtime that isn't pre-warmed to admit a new one. `0` means unbounded. Size pod memory from this value, see [Sizing](#sizing). |
5854
| `supervisor.idleTtlSeconds` | `600` | Seconds a runtime may sit idle before the worker stops it. `0` never stops an idle runtime. |
5955
| `supervisor.capacityWaitSeconds` | `30` | How long a call waits for a free slot when every runtime is busy at the cap, before it fails with a retryable error. |
60-
| `supervisor.peerRouting.enabled` | `false` | Replicas agree on which one starts each version and hand first calls to it, so a burst of first calls costs the fleet one cold start instead of one per replica. Turning it on adds a headless Service. A replica that can't reach the owner serves the call itself. |
61-
| `supervisor.peerRouting.promoteAfterForwards` | `10` | How many calls for one version a replica hands off before it starts its own runtime for that version. |
62-
| `resources`, `hpa.*`, `replicaCount` | See the chart reference | Pod resources and scaling. See [Sizing](#sizing). |
6356

6457
### Advanced settings
6558

6659
Set these environment variables through `extraEnv`. See the [chart reference](https://artifacthub.io/packages/helm/arcade/arcade) for details.
6760

6861
| Variable | Default | What it controls |
6962
| --- | --- | --- |
70-
| `ARCADE_SUPERVISOR_SHARD_PREWARM` | Off | With peer routing on, each replica warms only its share of the pre-warm list. This multiplies the fleet's warm coverage by the replica count. |
7163
| `ARCADE_SUPERVISOR_INVOKE_TIMEOUT` | 600 seconds | The longest a single tool call may run. |
7264
| `ARCADE_SUPERVISOR_PREWARM_CONCURRENCY` | `4` | How many runtimes start at once during boot. Keep it near the pod's core count. |
7365

@@ -77,8 +69,6 @@ Set these environment variables through `extraEnv`. See the [chart reference](ht
7769
- **Boot time:** with ten pre-warmed toolkits on 2 cores, the supervisor worker is ready in about 12 seconds. The eager worker takes 60 seconds or more to load every toolkit.
7870
- **Image size:** the supervisor image is 2.96 GB. The eager worker plus the deprecated-versions worker it replaces total 3.85 GB.
7971

80-
Set the pod's `resources` from `supervisor.maxChildren`, and scale out with `replicaCount` or `hpa.*`.
81-
8272
## Next steps
8373

8474
- [Self-host with Helm](/operate/deploy/helm) to install the platform

0 commit comments

Comments
 (0)