Automate Deployments
Learn how to set up automation rules for your Deployments in Humanitec.

Introduction

Humanitec makes it easy to automate Deployments in any Environment based on Rules whenever a new Image build is pushed by your CI pipelines. For example, you can configure Humanitec to re-deploy your Development Environment every time a new container image is built on the dev branch using the new container image.

Create an Automation Rule

To create an Automation Rule, you will need to have the Administrator role within your Organization or hold the Deployer role on the Environment. Learn more about RBAC in Humanitec here.
UI
CLI
API
  • Start on the Environment Settings Screen: Select the Environment in which you want to create an Automation Rule, click on the three dot menu next to the Environment name and select Environment Settings.
  • In the Automation section select + Add another rule.
  • Each Automation Rule can apply to All images, Selected images, or All images except images.
  • Optionally the git reference that the image was built from can be specified. For example: refs/heads/main or refs/tags/1.3.4.
Example for Automation Rules
Our CLI is currently in closed beta. Please contact us if you want to learn more.
You can create an Automation Rule via the Create New Automation Rule endpoint.
Once a new Image is built, Humanitec will initiate a new Deployment to the Environment based on your Automation Rules.
At any point in time, you can deploy manually by clicking the Deploy button in the top right corner of the App Details Screen.
All automatically triggered Deployments are tracked in the Deployment history. You can see - in real-time - when an automatic Deployment is running in your Environment.
Example for a automatically triggered Deployments

Deactivate Automation

If you would like to keep your Automation Rules but stop the automatic Deployments, you can deactivate your Automation Rules as described below.
To deactivate an Automation Rule, you will need to have the Administrator role within your Organization or hold the Deployer role on the Environment. Learn more about RBAC in Humanitec here.
UI
CLI
API
  • Start on the Environment Settings Screen: Select the Environment in which you want to deactivate an Automation Rule, click on the three dots next to the Environment name and select Environment Settings.
  • In the Automation section navigate to the Automation Rule you wish to deactivate.
  • Select Deactivate from the three dot menu.
Our CLI is currently in closed beta. Please contact us if you want to learn more.
You can deactivate an automation rule via the Update Existing Automation Rule endpoint.

Delete an Automation Rule

To delete an Automation Rule, you will need to have the Administrator role within your Organization or hold the Deployer role on the Environment. Learn more about RBAC in Humanitec here.
UI
CLI
API
  • Start on the Environment Settings Screen: Select the Environment in which you want to delete an Automation Rule, click on the three dots next to the Environment name and select Environment Settings.
  • In the Automation section navigate to the Automation Rule you wish to delete.
  • Select Delete from the three dot menu.
Our CLI is currently in closed beta. Please contact us if you want to learn more.
You can delete an Automation Rule via the Delete Automation Rule endpoint.
Copy link
On this page
Introduction
Create an Automation Rule
Deactivate Automation
Delete an Automation Rule