Appearance
deploy.rollout-static-bluegreen ​
Prepare a candidate slot and switch traffic for a static target
Prepare candidate slot, health-gate cutover, and complete static blue/green rollout.
Overview ​
| Property | Value |
|---|---|
| Workflow type | Linear |
| Library | App-deployments |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
rollout_uuid | uuid | Yes | — | — |
organization_uuid | uuid | Yes | — | — |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
rollout_uuid | uuid | No | — | — |
organization_uuid | uuid | No | — | — |
release_uuid | uuid | No | — | — |
deployment_target_uuid | uuid | No | — | — |
health_wait_retry_count | integer | No | — | — |
candidate_slot_name | string | No | — | — |
active_slot_name | string | No | — | — |
copied_count | integer | No | — | — |
deleted_count | integer | No | — | — |
health_phase | string | No | — | — |
auto_advance | string | No | — | — |
health_status | string | No | — | — |
health_decision | string | No | — | — |
health_checks | json | No | — | — |
health_retry_after_seconds | integer | No | — | — |
health_resume_action | string | No | — | — |
approval_resume_action | string | No | — | — |
approval_phase | string | No | — | — |
approval_required | boolean | No | — | — |
previous_slot_name | string | No | — | — |
origin_path | string | No | — | — |
invalidation_ref | string | No | — | — |
distribution_poll_count | integer | No | — | — |
distribution_status | string | No | — | — |
invalidation_status | string | No | — | — |
scheduled_next_action | string | No | — | — |
distribution_poll_scheduled_at | string | No | — | — |
health_wait_scheduled_at | string | No | — | — |
completed_at | string | No | — | — |
failed_at | string | No | — | — |
failed_at_state | string | No | — | — |
aborted_at | string | No | — | — |
failure_reason | string | No | — | — |
failure_type | string | No | — | — |
failed_action | 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 |
|---|---|---|---|---|---|
initiated | Yes | No | — | prepare | Blue/green rollout request accepted |
awaiting_approval | No | No | — | — | Manual approval required to continue rollout |
health_checking_post | No | No | — | — | Evaluate health after traffic switch |
health_checking_pre | No | No | — | — | Evaluate health before traffic switch |
preparing | No | No | — | prepare_candidate | Prepare candidate slot for rollout |
switching | No | No | — | switch_traffic | Switch primary traffic to candidate slot |
waiting | No | No | — | — | Wait for provider distribution propagation |
completed | No | Yes | Yes | — | Blue/green rollout completed successfully |
failed | No | Yes | No | — | Blue/green rollout failed |
State Diagram ​
Transitions ​
| From | Action | To | Description |
|---|---|---|---|
initiated | prepare | preparing | Initialize rollout metadata |
preparing | prepare_candidate | health_checking_pre | Candidate slot prepared |
health_checking_pre | evaluate_pre_switch_health | health_checking_pre | Run pre-switch health checks |
health_checking_pre | health_advance_pre_switch | switching | Pre-switch health approved |
health_checking_pre | health_wait | health_checking_pre | Health inconclusive; wait and retry |
health_checking_pre | approval_wait | awaiting_approval | Pause for operator pre-switch approval |
health_checking_pre | health_abort | failed | Abort rollout due to health decision |
switching | switch_traffic | waiting | Traffic switch initiated; await propagation |
waiting | poll_distribution | waiting | Poll provider distribution status |
waiting | distribution_ready | health_checking_post | Distribution propagated; run post-switch checks |
health_checking_post | evaluate_post_switch_health | health_checking_post | Run post-switch health checks |
health_checking_post | health_advance_post_switch | completed | Post-switch health approved |
health_checking_post | health_wait | health_checking_post | Health inconclusive; wait and retry |
health_checking_post | approval_wait | awaiting_approval | Pause for operator post-switch approval |
health_checking_post | health_abort | failed | Abort rollout due to health decision |
awaiting_approval | approve_pre_switch | switching | Operator approved pre-switch continuation |
awaiting_approval | approve_post_switch | completed | Operator approved rollout completion |
awaiting_approval | reject_approval | failed | Operator rejected rollout |
* (any state) | abort | failed | Abort workflow |
* (any state) | fail | failed | Mark workflow as failed |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "deploy.rollout-static-bluegreen",
"initial_data": {
"rollout_uuid": "value",
"organization_uuid": "value"
}
}