Host prewarms
cua.env.v1 SetHostWarm: the warm pool a host keeps for a prewarm, so the next creates of a shape start at once.
A prewarm's warm pool on a host (HostSpacesService.SetHostWarm): Spaces of one shape kept ready, claimed by the next creates of that shape, ended at the TTL or when the count is 0.
Source: libs/cua/proto/cua/env/v1/warm.proto.
Types in cua/env/v1/warm.proto#
SetHostWarmRequest#
Request for HostSpacesService.SetHostWarm.
| Field | # | Type | Description |
|---|---|---|---|
name | 1 | string | The pool (prewarm-<id>). |
image | 2 | string | Image of its members, as CreateHostSpaceRequest.image gives it. |
kind | 3 | string | Kind of its members (container, vm, microvm; empty: the image's). |
runtime | 4 | string | Engine of its members (empty: the host's default). |
cpus | 5 | uint32 | vCPUs of each member (0: the default). |
memory_mb | 6 | uint64 | Memory of each member, MiB (0: the default). |
count | 7 | uint32 | Members kept ready; 0 removes the pool. |
ttl_secs | 8 | uint64 | The pool keeps none after this long without a claim (0: one hour). |
SetHostWarmResponse#
Response for HostSpacesService.SetHostWarm.
| Field | # | Type | Description |
|---|---|---|---|
ready | 1 | uint32 | Members ready now. |
starting | 2 | uint32 | Members starting now. |
reason | 3 | string | Why it keeps fewer than asked (memory, the image), for people. |