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
{{ message }}
Repository navigation
Commit e4e8dec
Browse filesBrowse the repository at this point in the historyBrowse files
authored
agent-docs: clarify runner settings by host type (#813)
* docs: clarify runner settings by host
Co-Authored-By: Oz <oz-agent@warp.dev>
* docs: clarify Docker registry credentials
Co-Authored-By: Oz <oz-agent@warp.dev>
---------
Co-authored-by: warp-agent-staging[bot] <240773466+warp-agent-staging[bot]@users.noreply.github.com>
Co-authored-by: Oz <oz-agent@warp.dev>
Co-authored-by: Hong Yi Chen <hongyi@warp.dev>
Copy file name to clipboardExpand all lines: src/content/docs/factories/infrastructure-and-security.mdx
+13-15Lines changed: 13 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,31 +29,31 @@ flowchart LR
29
29
30
30
Self-hosting moves only the execution plane: with a managed self-hosted worker, repository checkouts, command execution, and the sandbox filesystem stay on machines you control, but content that enters prompts, results, transcripts, attachments, artifacts, or telemetry still flows through Warp and the providers you configure. See [deployment patterns](/platform/deployment-patterns/) and [self-hosting security and networking](/platform/self-hosting/security-and-networking/) for the broader data model.
31
31
32
-
The diagram below maps those boundaries for self-hosted execution; factory runs follow the same data model. See the [data security and boundaries](/platform/architecture/#data-security-and-boundaries)reference for a description of each data class.
32
+
Factory runs follow the [self-hosted data security and boundaries](/platform/architecture/#data-security-and-boundaries)model shown below.
33
33
34
34

35
35
36
36
## Runners
37
37
38
-
A runner defines the operating system, architecture, sandbox image, and instance shape (vCPUs and memory) for a factory agent. The factory's [definition](/factories/factory-as-code/) supplies its repositories, setup commands, and secrets; the execution host determines whether that runner uses Warp-hosted or self-hosted compute.
38
+
A runner defines the operating system, architecture, sandbox image, and instance shape (vCPUs and memory) for a factory agent. The factory's [definition](/factories/factory-as-code/) supplies its repositories, setup commands, and secrets.
39
39
40
-
Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.runner`, and an agent or automation can override it. A self-hosted runner must match the worker's operating system and architecture. Warp provisions hosted runners within your plan limits; your team provisions and operates self-hosted compute.
40
+
Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.runner`, and an agent or automation can override it. The execution host determines how the runner's compute settings are used:
41
41
42
-
See [cloud agent runner compute options](/platform/runners/) and [factory runner syntax](/factories/factory-as-code/#runnersnameyaml).
|`platform.os`, `platform.arch`, `platform.mac.version`| Selects the sandbox OS, architecture, and macOS VM version | Does not configure the host; the worker host determines the platform | Use Linux; the cluster and `pod_template` schedule nodes | Use Linux; the Docker daemon determines the architecture |
45
+
|`platform.linux.dockerImage`| Linux sandbox image | Ignored | Task and setup container image | Task container image |
46
+
|`platform.linux.registryCredentialSecretName`| Warp-managed private-registry credential | Ignored | Ignored; use `imagePullSecrets`| Ignored; configure registry credentials on the worker, such as in its Docker config |
47
+
|`instanceShape`| Sandbox size, subject to plan limits; omitted uses the workspace default | Ignored; the task uses host resources | Task-container requests and limits; overrides matching `pod_template` resources; omitted keeps template or cluster defaults | Task-container limits; omitted adds no limits |
48
+
49
+
Self-hosted runner settings do not provision worker capacity. Worker configuration controls host resources, registry authentication, volumes, node placement, and other backend policy.
50
+
51
+
See [cloud agent runner compute options](/platform/runners/), [factory runner syntax](/factories/factory-as-code/#runnersnameyaml), and the setup page for your [self-hosted worker backend](/platform/self-hosting/#managed-architecture).
43
52
44
53
## Choose an execution host
45
54
46
55
A factory runs its work on one of two execution hosts: Warp-hosted compute or a worker in the [managed self-hosting architecture](/platform/self-hosting/#managed-architecture).
47
56
48
-
| Decision area | Warp-hosted | Managed self-hosted |
49
-
| --- | --- | --- |
50
-
|**Compute**| Warp provisions the sandbox | Your team provisions the worker |
51
-
|**Checkout and commands**| Run on Warp-managed compute | Run on your infrastructure |
52
-
|**Control plane**| Runs through Warp | Runs through Warp |
53
-
|**Network**| Warp manages sandbox connectivity | The worker connects outbound to Warp; no inbound firewall port |
54
-
|**Private services**| Must be reachable from the hosted sandbox | Reachable through the worker's network access |
55
-
|**Operations**| Warp manages capacity and lifecycle | Your team manages capacity, isolation, updates, and availability |
56
-
57
57
To route factory work to a managed self-hosted worker (an Enterprise feature):
58
58
59
59
1.**Deploy a worker** - Use the [self-hosting overview](/platform/self-hosting/) to choose a managed backend and review its requirements, then connect a worker that authenticates to Warp with an agent API key. Workers run on `linux/amd64` and `linux/arm64`, and the worker's platform determines which workloads it can run.
@@ -74,8 +74,6 @@ Factories use managed self-hosting, so Warp still orchestrates their runs. The w
74
74
|**[Kubernetes](/platform/self-hosting/managed-kubernetes/)**| As a Kubernetes Job in the worker's namespace | The worker deployment, cluster, namespace RBAC, scheduling, admission policy, and capacity | Your team already operates Kubernetes or needs cluster-native policy and scheduling |
75
75
|**[Direct](/platform/self-hosting/managed-direct/)**| In a separate workspace directly on the worker host, sharing its OS and kernel | The worker daemon, host security, dependencies, capacity, and cleanup | A container runtime isn't available or runs need direct access to host resources |
76
76
77
-
All three structures keep execution on your infrastructure while Warp operates the control plane.
78
-
79
77
## Choose inference independently
80
78
81
79
Execution hosting doesn't select inference. Configure that boundary separately.
0 commit comments