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 dots 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.
  • The Automation Rules can be triggered when the Latest tag or Head of branch are pushed to Humanitec.
  • The Latest tag or Head of branch can be specified in the field That matches, using regular expressions. If the field is empty, it will match any Latest tag or Head of branch.
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.
  • If the toggle next to your Automation Rule is blue, it is Active. Click on the toggle to deactivate the Automation Rule.
  • Click Done.
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
You can delete an Automation Rule starting on the Environment Settings Screen.
  • Click Delete next to the Automation Rule that you want to remove.
  • Click Done.
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.