Cloud Run worker pool
Cloud Run resource for pull-based workloads, with no endpoint and manual scaling.
- Provider
- gcp
- Kind
- Worker
- Category
- Compute
- Official docs
- https://cloud.google.com/run/docs/resource-model
| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| accelerator | enum | none | gpu | asic | no | none | ▸ none |
| concurrency | integer | — | no | — | inherited |
| fanoutStrategy | enum | none | push | pull | hybrid | no | none | inherited |
| fanoutThreshold | integer | — | no | — | inherited |
| httpEndpoint | boolean | — | no | false | inherited |
| idempotent | boolean | — | no | false | inherited |
| instances | integer | — | no | — | inherited |
| managed | boolean | — | no | false | ▸ true |
| rateControl | enum | none | fixed | aimd | no | none | ▸ none |
| scalingMode | enum | manual | automatic | no | manual | inherited |
| schedule | string | — | no | — | inherited |
| trigger | enum | queue | stream | schedule | batch | manual | yes | — | ▸ queue |
| zoneRedundant | boolean | — | no | true | inherited |
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: "cloud-run-worker-pool", component: "google-cloud-run-worker-pool" }# yaml-language-server: $schema=../../schema/component.schema.json # Cloud Run worker pool: a Cloud Run resource for non-request workloads such as pull queues; worker # pools have no endpoint or URL and instances are scaled manually ("Cloud Run resource model"). # Like every Cloud Run resource a worker pool is regional and Cloud Run replicates it across the # zones of that region. schemaVersion: "1" type: "component" id: "google-cloud-run-worker-pool" kind: "worker" provider: "gcp" docs: "https://cloud.google.com/run/docs/resource-model" defaults: managed: true trigger: "queue" accelerator: "none" rateControl: "none" properties: scalingMode: type: "enum" values: ["manual", "automatic"] default: "manual" httpEndpoint: type: "boolean" default: false zoneRedundant: type: "boolean" default: true