kubernetes.deployment.wait_for_available

Poll a Kubernetes Deployment until rollout completes or timeout

Polls a Deployment until it finishes rolling out, fails the rollout, or the caller-supplied timeout elapses.

Inputs:

• connection_uuid: Cloud connection UUID (required)
• namespace: Deployment namespace (required)
• name: Deployment name (required)
• timeout_seconds: Total budget before this workflow gives up (default 300, cap 1800)
• poll_interval: Seconds between apiserver reads (default 5, cap 60)

Outputs:

• namespace, name, ready (bool), poll_count (int), last_observed_status (dict)

State data carries started_at_epoch so the deadline check survives across schedule_transition firings.

Overview

Property	Value
Workflow type	Atomic
Library	App-kubernetes
Version	1.0

Input Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	Yes	—	—
namespace	string	Yes	—	—
name	string	Yes	—	—
timeout_seconds	integer	No	—	Total wait budget in seconds (default 300, cap 1800)
poll_interval	integer	No	—	Seconds between status reads (default 5, cap 60)
workflow_run_id	string	No	—	Engine workflow run id for DAG step execution
organization_uuid	uuid	No	—	—

Output Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	No	—	—
organization_uuid	uuid	No	—	—
namespace	string	No	—	—
name	string	No	—	—
ready	boolean	No	—	—
poll_count	integer	No	—	—
last_observed_status	json	No	—	—
timeout_seconds	integer	No	—	—
poll_interval	integer	No	—	—
workflow_run_id	string	No	—	Engine workflow run id for DAG step execution
started_at_epoch	integer	No	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
polling	Yes	No	—	—	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
polling	poll	polling	—
polling	finish	completed	—
polling	timeout	failed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "kubernetes.deployment.wait_for_available",
  "initial_data": {
    "connection_uuid": "value",
    "namespace": "value",
    "name": "value"
  }
}