Terraform Provider for Azure DevOps

The AzDO (Azure DevOps) Provider supports Terraform 0.11.x and later - but Terraform 0.12.x is recommended.

• Terraform Website
• AzDO Website
• AzDO Provider Documentation
• AzDO Provider Usage Examples

Checkout our Project Roadmap.

Important!

This repository is a work in progress and is not yet suitable for production workloads. Community contributions are welcome.

Looking for AzDO Provider Documentation?

The documentation for things like resource specific usage examples, required parameters and default values can be found under the /website directory, which contains all of the AzDO Provider Documentation.

Configuration Values

Environment Variable	Description	Required?	Example
AZDO_PERSONAL_ACCESS_TOKEN	A personal access token that grants access to Azure DevOps APIs within the org specified by AZDO_ORG_SERVICE_URL	yes	d7894a91db7610e39decbe09b2dfd449ed2ed5a
AZDO_ORG_SERVICE_URL	URL of the Azure DevOps org in which resources will be provisioned/managed	yes	https://dev.azure.com/contoso-org
AZDO_GITHUB_SERVICE_CONNECTION_PAT	If running the acceptance tests, you will need this defined in order to validate the GitHub Service Connection resource	for acceptance tests only	a9194a91d75643e39decbe09b2dfd558dd2abca
AZDO_PRJ_CREATE_DELAY	Delay (in seconds) to insert after creation of projects. This was determined to be useful based on observed behavior of the AzDO APIs	no	10

Usage Example

• Installing the provider

./scripts/build.sh          # build & test provider code
./scripts/local-install.sh  # install provider locally

• Provision project, repository and build pipeline using the provider

# Make sure to set the following environment variables:
#   AZDO_PERSONAL_ACCESS_TOKEN
#   AZDO_ORG_SERVICE_URL
provider "azuredevops" {
  version = ">= 0.0.1"
}

resource "azuredevops_project" "project" {
  project_name = "My Awesome Project"
  description  = "All of my awesomee things"
}

resource "azuredevops_azure_git_repository" "repository" {
  project_id = azuredevops_project.project.id
  name       = "My Awesome Repo"
  initialization {
    init_type = "Clean"
  }
}

resource "azuredevops_build_definition" "build_definition" {
  project_id = azuredevops_project.project.id
  name       = "My Awesome Build Pipeline"
  path       = "\\"

  repository {
    repo_type   = "TfsGit"
    repo_name   = azuredevops_azure_git_repository.repository.name
    branch_name = azuredevops_azure_git_repository.repository.default_branch
    yml_path    = "azure-pipelines.yml"
  }
}

Contributing

Interested in contributing to the provider? Great, we need your help. Get started by reading the contributing document.