You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: app/en/operate/deploy/helm/page.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,7 +60,7 @@ Once the pods are running, open your configured hostname and sign in through you
60
60
Configure the platform through Helm values. The chart covers:
61
61
62
62
-**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
64
64
-**Identity** — your OIDC identity provider and [OAuth providers](/references/auth-providers)
65
65
-**Data stores** — bundled or external PostgreSQL and Redis
66
66
-**Networking** — ingress or Gateway API, TLS, and the `engine.ssrfAllowlist` for reaching internal services
Copy file name to clipboardExpand all lines: app/en/operate/deploy/worker/page.mdx
+1-11Lines changed: 1 addition & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,9 +16,7 @@ The worker ships as two images built from the same commit. The image you choose
16
16
| Image | Process model |
17
17
| --- | --- |
18
18
|`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. |
22
20
23
21
## How the supervisor worker behaves
24
22
@@ -50,24 +48,18 @@ Set these values under `workerDefaults` to apply them to every worker, or on an
50
48
51
49
| Value | Default | What it controls and when to change it |
52
50
| --- | --- | --- |
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. |
55
51
|`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. |
56
52
|`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. |
57
53
|`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). |
58
54
|`supervisor.idleTtlSeconds`|`600`| Seconds a runtime may sit idle before the worker stops it. `0` never stops an idle runtime. |
59
55
|`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). |
63
56
64
57
### Advanced settings
65
58
66
59
Set these environment variables through `extraEnv`. See the [chart reference](https://artifacthub.io/packages/helm/arcade/arcade) for details.
67
60
68
61
| Variable | Default | What it controls |
69
62
| --- | --- | --- |
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. |
71
63
|`ARCADE_SUPERVISOR_INVOKE_TIMEOUT`| 600 seconds | The longest a single tool call may run. |
72
64
|`ARCADE_SUPERVISOR_PREWARM_CONCURRENCY`|`4`| How many runtimes start at once during boot. Keep it near the pod's core count. |
73
65
@@ -77,8 +69,6 @@ Set these environment variables through `extraEnv`. See the [chart reference](ht
77
69
-**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.
78
70
-**Image size:** the supervisor image is 2.96 GB. The eager worker plus the deprecated-versions worker it replaces total 3.85 GB.
79
71
80
-
Set the pod's `resources` from `supervisor.maxChildren`, and scale out with `replicaCount` or `hpa.*`.
81
-
82
72
## Next steps
83
73
84
74
-[Self-host with Helm](/operate/deploy/helm) to install the platform
0 commit comments