Copy page

Unidades que controla tu código

Reglas de despliegue

Cuando despliegas una imagen nueva (o cambias algo de la plantilla de pods), las unidades en marcha quedan obsoletas. El rollout de la política decide cómo se reemplazan.

Regla	Comportamiento	Úsala para
rolling	Reemplaza las unidades obsoletas por lotes, creando primero la nueva. La capacidad nunca baja	APIs sin estado, workers
replace_idle	Reemplaza ahora toda unidad obsoleta que no esté asignada ni ocupada, como mucho una cuarta parte de las unidades a la vez y nunca por debajo de min_units listas. Las asignadas u ocupadas se reemplazan cuando terminan: por su salida, parada o destrucción, o en su siguiente señal idle	lobbies, partidas
next_start	No toca las unidades en marcha. El cambio se aplica la próxima vez que la plataforma crea un pod para esa unidad: un arranque tras una parada, un pod perdido, una unidad caliente nueva	mundos privados, parcelas

replace_idle necesita señales: sin ellas no se puede saber qué es "idle" y la política se rechaza con invalid-field-value (details empieza por replace_idle_needs_signals). Es el valor por defecto del modo code.

Las versiones mezcladas son normales con replace_idle y next_start. Allocate prefiere unidades que ya están en la plantilla más nueva y la consola muestra cuántas siguen en la antigua.

Leer el estado

GET .../units/policy informa del despliegue:

Code
{
  "rollout": "replace_idle",
  "rollout_status": {
    "strategy": "replace_idle",
    "target_template": "9c1f...",
    "stale_units": 2,
    "replaced_units": 7,
    "waiting_on": [{"key": "duel-81", "why": "allocated"}],
    "started_at": "2026-10-14T10:00:00Z"
  }
}

y el registro de eventos lleva rollout.started, rollout.completed y rollout.paused (falló un reemplazo). rollout_status está en la referencia de la API como RolloutStatusResponse.

Elige una

• Una partida nunca debe cortarse y las unidades son efímeras: replace_idle.
• Cada unidad guarda el mundo de un jugador y puede pasar semanas detenida: next_start.
• Las unidades son intercambiables y sin estado: rolling.