Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.envzero.com/llms.txt

Use this file to discover all available pages before exploring further.

To integrate with Azure DevOps, you need an Azure DevOps user with Basic access level on the necessary Azure DevOps organization and View permissions for this node permission for the project. We recommend that this user be a designated shared bot user, as env zero will perform actions as this user on the project/repository.If you do not have the correct permissions, ask an administrator or a different user with those permissions to create the template.

​
Prerequisites

Before creating an Azure DevOps template, you need an Azure DevOps VCS connection configured in your organization. To set one up, go to Organization Settings > VCS and create a new Azure DevOps connection. Learn more: Managing VCS Connections

​
New Template

1

Create Template

Click ADD A NEW TEMPLATE on the top right in the Templates screen. Pick your template type, enter a name for the template, and click NEXT.
2

Select Azure DevOps

Click on the Azure DevOps button.
3

Select VCS Connection

Select a pre-configured Azure DevOps VCS connection from the dropdown. If no connection exists, click Add VCS Connection to create one.
4

Select Repository

Pick the repository from the list of accessible Azure DevOps projects.
5

Configure Source

If you would like to pull the code from a specific revision or branch, enter that in the Branch field. Leaving this field empty will use your default branch, which is usually “master”/“main”.Enter the folder your IaC files are located in under the IaC type folder. If your IaC files are in the root of the repository, leave this empty.
6

Configure Variables

Click NEXT to proceed to the variables section. Add environment and Terraform variables that you’d like to be used during deployment, and then click NEXT to go to the final “Projects” section.
7

Assign Projects

Pick the projects that you’d like to have access to deploy this template, and then click DONE to create the template.
Troubleshoot
  • Can’t find your repository? Verify that the VCS connection has access to the necessary Azure DevOps organization/project. You can check the available repositories in Organization Settings > VCS by selecting the relevant connection.
Azure DevOps old domain name URLsRepositories using the old domain name URLs are not supported, i.e., if the URL for your git repository is in the format of <organization-name>.visualstudio... an environment won’t be created.For more information about old domain name URLs and how to resolve the issue, read here.

​
Existing Template

If you would like to integrate an existing template with Azure DevOps:
  1. From the Templates screen, click on Settings for the appropriate template you would like to integrate with Azure DevOps.
  2. Click on the VCS step. From there you can click on the Azure DevOps button, and integrate with Azure DevOps as you would for a new template.
Additional Content

​
Next steps