Automate Deployments
Learn how to set up automation rules for your Deployments in Humanitec.
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.
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
, orAll images except images
. - Optionally the git reference that the image was built from can be specified. For example:
refs/heads/main
orrefs/tags/1.3.4
.

Example for Automation Rules
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
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.
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.
Last modified 5mo ago