terraform-azure-devops_skill

Overview

This skill generates Terraform configurations for Azure DevOps resources to manage Azure DevOps infrastructure as code. It automates creation of projects, Git repositories, build pipelines, and variable groups using the Microsoft Azure DevOps Terraform provider. Use it to codify DevOps environments, make deployments repeatable, and keep configuration in version control.

How this skill works

The skill emits Terraform HCL snippets and provider setup for the microsoft/azuredevops provider, including examples for provider configuration, project resources, Git repositories, build definitions, and variable groups. It inspects desired resource attributes (name, project_id, visibility, pipeline YAML path, variables) and produces complete resource blocks ready to paste into a Terraform module. The outputs are focused on practical, minimal examples you can adapt to your org and secrets management workflow.

When to use it

• Provisioning new Azure DevOps projects and enabling core features (repos, pipelines, artifacts).
• Creating and initializing Git repositories consistently across teams.
• Defining CI build pipelines that source YAML from repo branches.
• Managing variable groups and secrets for pipeline reuse.
• Adopting infrastructure-as-code practices for DevOps configuration.

Best practices

• Use a dedicated service account or managed identity and store the personal access token (PAT) securely in a secrets manager or CI variable.
• Keep terraform state remote and locked (e.g., Azure Storage + Blob locking) when multiple engineers apply changes.
• Parameterize names, visibility, and sensitive values via variables to reuse modules across environments.
• Initialize repositories with a clear default branch and pipeline YAML to bootstrap CI immediately.
• Mark secrets as secret_value in variable groups and avoid committing credentials to VCS.

Example use cases

• Create a standardized project template with consistent features and visibility for each team.
• Provision multiple Git repositories and initialize them programmatically during onboarding.
• Define a CI pipeline resource that points to azure-pipelines.yml in a repository branch.
• Manage environment-specific variable groups for production, staging, and development.