# azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops architecture

> Architecture diagram of the GitHub repository azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops
- Repository: https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops

## Overview

This Terraform AVM pattern bootstraps an Azure DevOps CI/CD environment for an application landing zone. The user configures deployment mode, environments, identity, and agent options; Terraform provisions Azure DevOps projects and delivery resources alongside supporting Azure infrastructure, enabling teams to deploy through environment-specific federated credentials. The README documents the capability relationships shown here; no source excerpts were available, so implementation-level calls and ordering are not inferred.

Main entry points: [`main.tf`](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.tf) (Terraform module), [`main.azuredevops.pipelines.tf`](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.pipelines.tf) (Pipeline definitions), [`main.azuredevops.service.connections.tf`](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.service.connections.tf) (Service connections), [`main.azure.agents.tf`](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.agents.tf) (Agent compute)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Module bootstrap"]
  node_module["Terraform module<br/>[main.tf]"]
end

subgraph group_devops["Azure DevOps"]
  node_project["Project"]
  node_repositories["Repositories"]
  node_repo_files["Repository seeding"]
  node_pipelines["Pipeline definitions"]
  node_environments["Environments"]
  node_variable_groups["Variable groups"]
  node_security_groups["Security groups"]
end

subgraph group_identity["Identity and access"]
  node_service_connections["Service connections"]
  node_environment_identities["Environment identities"]
  node_federated_credentials["Federated credentials"]
end

subgraph group_agents["Agents and networking"]
  node_resource_groups["Resource groups"]
  node_agent_compute["Agent compute"]
  node_agent_pool["Agent pool"]
  node_network["Virtual network"]
end

subgraph group_state["State storage"]
  node_state_storage[("Terraform state")]
end

node_operator(("Module operator"))
node_azure["Azure Resource Manager"]
node_azure_devops["Azure DevOps"]

node_operator -->|"configures"| node_module
node_module -->|"provisions resources"| node_azure
node_module -->|"provisions platform"| node_azure_devops
node_pipelines -->|"wired to"| node_repositories
node_repo_files -.->|"seeds optionally"| node_repositories
node_pipelines -->|"uses pool"| node_agent_pool
node_service_connections -->|"backed by"| node_environment_identities
node_federated_credentials -->|"enables federation"| node_service_connections
node_module -->|"creates groups"| node_resource_groups
node_module -->|"deploys agents"| node_agent_compute
node_agent_compute -->|"uses subnets"| node_network
node_module -->|"provisions state"| node_state_storage
node_module -->|"creates or attaches"| node_project
node_module -->|"creates environments"| node_environments
node_module -->|"creates groups"| node_variable_groups
node_module -->|"configures permissions"| node_security_groups

click node_module "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.tf"
click node_project "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.project.tf"
click node_repositories "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.repositories.tf"
click node_repo_files "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.repository.files.tf"
click node_pipelines "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.pipelines.tf"
click node_environments "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.environments.tf"
click node_variable_groups "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.variable.groups.tf"
click node_security_groups "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.groups.tf"
click node_service_connections "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.service.connections.tf"
click node_environment_identities "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.managed.identities.tf"
click node_federated_credentials "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.agents.uami.tf"
click node_resource_groups "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.resource.groups.tf"
click node_agent_compute "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.agents.tf"
click node_agent_pool "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.agents.tf"
click node_network "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.virtual.network.tf"
click node_state_storage "https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.storage.tf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_module toneBlue
class node_project,node_repositories,node_repo_files,node_pipelines,node_environments,node_variable_groups,node_security_groups toneAmber
class node_service_connections,node_environment_identities,node_federated_credentials toneMint
class node_resource_groups,node_agent_compute,node_agent_pool,node_network toneRose
class node_state_storage,node_operator,node_azure,node_azure_devops toneIndigo
```

## Components

### Module bootstrap

- [Terraform module](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.tf): `main.tf`

### Azure DevOps

- [Project](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.project.tf): `main.azuredevops.project.tf`
- [Repositories](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.repositories.tf): `main.azuredevops.repositories.tf`
- [Repository seeding](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.repository.files.tf): `main.azuredevops.repository.files.tf`
- [Pipeline definitions](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.pipelines.tf): `main.azuredevops.pipelines.tf`
- [Environments](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.environments.tf): `main.azuredevops.environments.tf`
- [Variable groups](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.variable.groups.tf): `main.azuredevops.variable.groups.tf`
- [Security groups](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.groups.tf): `main.azuredevops.groups.tf`

### Identity and access

- [Service connections](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.service.connections.tf): `main.azuredevops.service.connections.tf`
- [Environment identities](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.managed.identities.tf): `main.azure.managed.identities.tf`
- [Federated credentials](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.agents.uami.tf): `main.azure.agents.uami.tf`

### Agents and networking

- [Resource groups](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.resource.groups.tf): `main.azure.resource.groups.tf`
- [Agent compute](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.agents.tf): `main.azure.agents.tf`
- [Agent pool](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azuredevops.agents.tf): `main.azuredevops.agents.tf`
- [Virtual network](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.virtual.network.tf): `main.azure.virtual.network.tf`

### State storage

- [Terraform state](https://github.com/azure/terraform-azure-avm-ptn-alz-application-landing-zone-cicd-bootstrap-azure-devops/blob/main/main.azure.storage.tf): `main.azure.storage.tf`

### Other components

- **Module operator**
- **Azure Resource Manager**
- **Azure DevOps**

## Connections

- Module operator → Terraform module: configures (evidence: `README.md`)
- Terraform module → Azure Resource Manager: provisions resources (evidence: `README.md`)
- Terraform module → Azure DevOps: provisions platform (evidence: `README.md`)
- Pipeline definitions → Repositories: wired to (evidence: `README.md`)
- Repository seeding → Repositories: seeds optionally (evidence: `README.md`)
- Pipeline definitions → Agent pool: uses pool (evidence: `README.md`)
- Service connections → Environment identities: backed by (evidence: `README.md`)
- Federated credentials → Service connections: enables federation (evidence: `README.md`)
- Terraform module → Resource groups: creates groups (evidence: `README.md`)
- Terraform module → Agent compute: deploys agents (evidence: `README.md`)
- Agent compute → Virtual network: uses subnets (evidence: `README.md`)
- Terraform module → Terraform state: provisions state (evidence: `README.md`)
- Terraform module → Project: creates or attaches (evidence: `README.md`)
- Terraform module → Environments: creates environments (evidence: `README.md`)
- Terraform module → Variable groups: creates groups (evidence: `README.md`)
- Terraform module → Security groups: configures permissions (evidence: `README.md`)
