Deployment lifecycle and flow

This guide explains what happens after a deployment is created—from initialization through rollout and rollback.

Lifecycle stages

Each deployment progresses through a series of statuses:

Status	Description
creating_approval	Waiting for approval before the deployment can be created.
creating_approval_denied	The request to create the deployment was denied.
creating	The deployment is being created.
waiting_for_instances	The deployment is initializing instances.
running	The deployment is up and running.
finalizing	The deployment is wrapping up final steps.
finalized	The deployment is complete and stable.
cancelling	The deployment is being canceled.
cancelled	The deployment was successfully canceled.
failed	Something went wrong, and the deployment failed.
rolling_back	The deployment is being rolled back to a previous stable version.
rolled_back	The rollback is complete.
deleting	The deployment is being deleted.
deleted	The deployment was successfully deleted.

Built-in rollout strategies

Nullplatform supports two primary deployment strategies.

Initial deployment

Used when the scope has no previous deployments.

Steps:

• Provision infrastructure
• Wait for instance readiness
• Mark the deployment as RUNNING > FINALIZED

Blue-Green deployment

Used when replacing an existing deployment. This strategy:

• Provisions a new environment ("green")
• Gradually shifts traffic from the existing deployment ("blue")
• Allows rollback if needed (manual or automatic)

Strategy diagram

Strategy data

When interacting with deployments via API or telemetry, the strategy_data object tracks the current rollout state.

Field	Type	Description
switched_traffic	integer	Current percentage of traffic on new version (0-100)
desired_switched_traffic	integer	Target traffic percentage for new version
amount_instances_to_wait	integer	Required number of instances before proceeding
healthy_instances	integer	Current count of healthy instances
launched_instances	integer	Total instances launched
switch_traffic_step	boolean	Indicates active traffic switching phase

Defining your own strategies

You can define custom strategies in the UI using Platform Settings > Deployment Strategies.

For details, see Reusable strategies.