Skip to content

Application Deployments

Deployments can target all services in an app instance or only selected services.

Within a deployment, Wodby orders services using both explicit stack depends rules and the current links between app services. If two linked services are deployed together, the linked target service is deployed first.

Deployments are transactional by default. If one of the app service deployments fails, Wodby rolls back the entire deployment.

During the first deployment, Wodby deploys all non-buildable services immediately. Buildable services usually leave the app instance in awaiting until a deployment is triggered with build information from a CI system.

Every deployment is associated with a specific stack revision of the app instance.

Deployments usually triggered in the following ways:

  • first deployment after app creation
  • deployment of builds requested from CI
  • automated partial deployments, for example after certificate renewal
  • manual deployment from the UI

Build deployment

Deployments from CI are triggered with wodby ci deploy.

Each build deployment creates a new deployment record associated with the selected build. One build can contain image outputs for multiple app services. CI-triggered deployments can also skip post-deployment scripts for the built services when needed.

New deployment

A new deployment can be started manually from Apps > [App] > Deploys > New Deployment.

In that flow you can:

  • choose which services to deploy
  • force deployment even when manifests have not changed
  • disable post-deployment scripts for services that provide them
  • use Skip rollback on failure when you want to inspect the failed state instead of restoring the previous deployment
  • choose which successful build to deploy for buildable services, as long as the build belongs to the same stack revision as the current app instance

If you deploy only a subset of services, Wodby applies that ordering only inside the selected set.

Needs redeploy

When app-service configuration changes, the app instance can be marked as needs redeploy.

This means configuration has changed, but those changes have not yet been applied to the running deployment.

Auto redeployment

Some redeployments happen automatically. For example, when a route certificate is renewed successfully, the related app services may be redeployed automatically.