deploy.cloudrun.rollout-immediate ​
Deploy a Cloud Run revision and move all traffic to it after readiness.
Overview ​
| Property | Value |
|---|---|
| Workflow type | Dag |
| Library | App-deployments |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
organization_uuid | uuid | Yes | — | Organization UUID. |
deployment_target_uuid | uuid | Yes | — | Target UUID. |
release_uuid | uuid | Yes | — | DeploymentRelease UUID. |
rollout_uuid | uuid | No | — | DeploymentRollout UUID when already created. |
service_name | string | Yes | — | Logical service name. |
image_reference | string | Yes | — | Image reference to deploy. |
runtime_overrides | json | No | — | Config overrides. |
secrets | list | No | — | Runtime secret requirements. |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
organization_uuid | uuid | No | — | Echoed organization UUID. |
deployment_target_uuid | uuid | No | — | Target UUID. |
release_uuid | uuid | No | — | Release UUID. |
rollout_uuid | uuid | No | — | Rollout UUID. |
workflow_run_uuid | uuid | No | — | DAG run UUID created by the engine. |
image_reference | string | No | — | Image reference to deploy. |
runtime_overrides | json | No | — | Config overrides carried through DAG startup. |
secrets | list | No | — | Runtime secret requirements carried through DAG startup. |
bind_config | json | No | — | Intermediate bind-config step output. |
bind_secrets | json | No | — | Intermediate bind-secrets step output. |
upsert_service | json | No | — | Intermediate Cloud Run service upsert output. |
wait_ready | json | No | — | Intermediate Cloud Run readiness output. |
apply_invoker_policy | json | No | — | Intermediate IAM policy step output. |
shift_all_traffic | json | No | — | Intermediate traffic shift output. |
connection_uuid | uuid | No | — | GCP connection UUID. |
project_id | string | No | — | Effective project. |
region | string | No | — | Cloud Run region. |
service_name | string | No | — | Cloud Run service name. |
service_url | string | No | — | Cloud Run service URL. |
revision | string | No | — | Ready revision receiving 100 percent traffic. |
traffic | json | No | — | Final traffic split. |
status | string | No | — | Rollout status. |
failure_reason | string | No | — | Engine failure reason. |
failed_step | json | No | — | Failed DAG step envelope. |
failed_layer | json | No | — | Failed DAG layer envelope. |
failed_at_state | string | No | — | State where failure occurred. |
compensation_trigger | string | No | — | DAG compensation trigger. |
comp_queue | list | No | — | Remaining DAG compensation layer queue. |
comp_current_layer | integer | No | — | Current DAG compensation layer index. |
comp_retry_count | integer | No | — | DAG compensation retry count. |
error | string | No | — | Error message. |
error_type | string | No | — | Error class. |
DAG Layers ​
| # | Layer | Steps | Compensation |
|---|---|---|---|
| 1 | bind_config | deploy.service.bind-config | — |
| 2 | bind_secrets | deploy.service.bind-secrets | — |
| 3 | deploy_revision | gcp.run.service.upsert | — |
| 4 | wait_revision | gcp.run.service.wait-ready | — |
| 5 | access_and_traffic | gcp.run.service.set-iam-policy, gcp.run.service.update-traffic | — |
Execution Flow ​
Sub-workflows ​
| Sub-workflow | Step name |
|---|---|
deploy.service.bind-config | bind_config |
deploy.service.bind-secrets | bind_secrets |
gcp.run.service.upsert | upsert_service |
gcp.run.service.wait-ready | wait_ready |
gcp.run.service.set-iam-policy | apply_invoker_policy |
gcp.run.service.update-traffic | shift_all_traffic |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "deploy.cloudrun.rollout-immediate",
"initial_data": {
"organization_uuid": "value",
"deployment_target_uuid": "value",
"release_uuid": "value",
"service_name": "value"
}
}