Northflank Sandboxes
MicroVM or gVisor sandboxes on Northflank's cloud or your own, ephemeral or persistent.
- Provider
- default
- Kind
- Worker
- Category
- Compute
- Official docs
- https://northflank.com/docs/v1/application/sandboxes
| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| accelerator | enum | none | gpu | asic | no | none | inherited |
| concurrency | integer | — | no | — | inherited |
| deployment | enum | northflank-cloud | byoc | no | northflank-cloud | inherited |
| fanoutStrategy | enum | none | push | pull | hybrid | no | none | inherited |
| fanoutThreshold | integer | — | no | — | inherited |
| idempotent | boolean | — | no | false | ▸ false |
| instances | integer | — | no | — | inherited |
| isolation | enum | microvm | gvisor | no | microvm | inherited |
| managed | boolean | — | no | false | ▸ true |
| persistentVolume | boolean | — | no | false | inherited |
| rateControl | enum | none | fixed | aimd | no | none | inherited |
| schedule | string | — | no | — | inherited |
| trigger | enum | queue | stream | schedule | batch | manual | yes | — | ▸ manual |
Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.
Pure push fan-out over a social graph is brutal at the tail: one post from an account with millions of followers becomes millions of cache writes. A follower threshold above which readers merge at read time bounds that write amplification.
- — all of these hold:
- — the node's `fanoutStrategy` is "push"
- — the node's `fanoutThreshold` has no value
- — the design contains a node of kind graph-database
One worker pool consuming several queues lets a slow or poisoned queue starve the others. That is precisely what the design's per-queue isolation requirement forbids.
- — all of these hold:
- — the node has more than 1 incoming edge from a queue
- — the design requirement `isolation.perQueue` is true
A stateful compute node pinned to exactly one availability zone disappears with that zone, and its state goes with it. Nodes inside a cell are exempt, because there the cell is deliberately single-zone and redundancy comes from the other cells.
- — all of these hold:
- — the node's `stateless` is false
- — the node sits inside exactly 1 availability-zone group
- — this does not hold:
- — the node sits inside at least one cell group
nodes:
- { id: "northflank-sandbox", component: "northflank-sandbox" }# yaml-language-server: $schema=../../schema/component.schema.json # Northflank Sandboxes: isolated Linux environments, each on its own kernel, for LLM-generated code, user submissions and agents. # Per the Northflank sandboxes docs, Northflank Cloud isolates CPU work in microVMs and GPU work in gVisor, sandboxes boot in # under a second, and the same sandboxes run in your own cloud (BYOC) with a configurable runtime. schemaVersion: "1" type: "component" id: "northflank-sandbox" kind: "worker" provider: "default" docs: "https://northflank.com/docs/v1/application/sandboxes" aliases: ["Northflank Sandboxes"] defaults: managed: true trigger: "manual" idempotent: false properties: deployment: type: "enum" values: ["northflank-cloud", "byoc"] default: "northflank-cloud" isolation: type: "enum" values: ["microvm", "gvisor"] default: "microvm" persistentVolume: type: "boolean" default: false