k8s.app.set-image

Patch a Deployment's container image and wait for rollout to be Available. Helm-safe — only touches the image field.

Patch a Deployment's container image and wait for rollout to be Available.

Overview

Property	Value
Workflow type	Dag
Library	App-kubernetes
Version	1.0

Input Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	Yes	—	CloudConnection UUID for the target Kubernetes cluster, picked from the organization's kubernetes-type connections.
namespace	string	Yes	—	Namespace the Deployment lives in
name	string	Yes	—	Deployment name
container	string	Yes	—	Name of the container within the pod template to update
image	string	Yes	—	New image reference, e.g. registry/repo:tag
timeout_seconds	integer	No	—	Total wait budget for rollout to become Available (default 300, cap 1800)
poll_interval	integer	No	—	Seconds between status reads while waiting (default 5, cap 60)

Output Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	No	—	CloudConnection UUID for the target cluster, echoed from input.
namespace	string	No	—	—
name	string	No	—	—
container	string	No	—	—
image	string	No	—	—
timeout_seconds	integer	No	—	—
poll_interval	integer	No	—	—
workflow_run_uuid	string	No	—	Engine-stamped DAG run id written by action_start.
set_image	json	No	—	—
wait_ready	json	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	—	—

DAG Layers

#	Layer	Steps	Compensation
1	set_image	kubernetes.deployment.set_image	—
2	wait_ready	kubernetes.deployment.wait_for_available	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
kubernetes.deployment.set_image	set_image
kubernetes.deployment.wait_for_available	wait_ready

API Usage

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

{
  "workflow_type": "k8s.app.set-image",
  "initial_data": {
    "connection_uuid": "value",
    "namespace": "value",
    "name": "value",
    "container": "value"
  }
}