Skip to content

Commit e4e8dec

Browse files
warp-agent-staging[bot]oz-agenthongyi-chen
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>
1 parent 6a53112 commit e4e8dec

1 file changed

Lines changed: 13 additions & 15 deletions

File tree

‎src/content/docs/factories/infrastructure-and-security.mdx‎

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -29,31 +29,31 @@ flowchart LR
2929

3030
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.
3131

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.
3333

3434
![Self-hosted data security and boundaries diagram showing what stays in customer infrastructure, what Warp retains, and what transits Warp to model providers](../../../assets/agent-platform/data-security-boundaries.png)
3535

3636
## Runners
3737

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.
3939

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:
4141

42-
See [cloud agent runner compute options](/platform/runners/) and [factory runner syntax](/factories/factory-as-code/#runnersnameyaml).
42+
| Setting | Warp-hosted | Direct | Kubernetes | Docker |
43+
| --- | --- | --- | --- | --- |
44+
| `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).
4352

4453
## Choose an execution host
4554

4655
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).
4756

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-
5757
To route factory work to a managed self-hosted worker (an Enterprise feature):
5858

5959
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
7474
| **[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 |
7575
| **[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 |
7676

77-
All three structures keep execution on your infrastructure while Warp operates the control plane.
78-
7977
## Choose inference independently
8078

8179
Execution hosting doesn't select inference. Configure that boundary separately.

0 commit comments

Comments
 (0)