# microsoft/azure-pipelines-tasks architecture

> Architecture diagram of the GitHub repository microsoft/azure-pipelines-tasks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/azure-pipelines-tasks
- Repository: https://github.com/microsoft/azure-pipelines-tasks

## Overview

Azure Pipelines Tasks is a catalog of first-class build and release tool runners: a pipeline invokes a task, which interprets inputs and performs work such as deploying Azure resources, transferring artifacts, or managing configuration. The repository contains many independently versioned task implementations rather than one shared runtime pipeline. The graph highlights documented task domains and sampled execution paths, plus BuildConfigGen as an internal task-configuration layer. Several domain nodes represent directories whose implementations were not sampled; their internal calls are therefore omitted.

Main entry points: [`BuildConfigGen/Program.cs`](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/Program.cs) (Configuration coordinator), [`Tasks/AzureAppConfigurationExportV10/taskController.ts`](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationExportV10/taskController.ts) (Export settings), [`Tasks/AzureAppConfigurationImportV10/taskController.ts`](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationImportV10/taskController.ts) (Import settings), [`Tasks/AzureAppConfigurationSnapshotV1/taskController.ts`](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationSnapshotV1/taskController.ts) (Create snapshot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_task["Pipeline tasks"]
  node_task_catalog["Other task runners"]
end

subgraph group_config["App configuration"]
  node_appconfig_export["Export settings<br/>[taskController.ts]"]
  node_appconfig_import["Import settings<br/>[taskController.ts]"]
  node_appconfig_snapshot["Create snapshot<br/>[taskController.ts]"]
  node_keyvault_helper["Key Vault client<br/>[keyVaultClient.ts]"]
end

subgraph group_delivery["Deployment and provisioning"]
  node_webapp_deploy["Web app deployment"]
  node_function_deploy["Function deployment"]
  node_resource_deploy["Resource deployment"]
  node_container_apps["Container Apps"]
  node_kubernetes_function["Kubernetes functions"]
  node_iot_edge["IoT Edge"]
end

subgraph group_integrations["Artifacts and integrations"]
  node_build_artifacts["Build artifact download<br/>[main.ts]"]
  node_package_download["Package download<br/>[main.ts]"]
  node_github_release_download["GitHub release download<br/>[main.ts]"]
  node_github_release_manage["GitHub release management<br/>[main.ts]"]
  node_gradle_auth["Gradle authentication<br/>[main.ts]"]
end

subgraph group_internal["Configuration generation"]
  node_buildconfig_program["Configuration coordinator<br/>[Program.cs]"]
  node_buildconfig_version["Task versions<br/>[TaskVersion.cs]"]
  node_buildconfig_git["Git utilities<br/>[GitUtil.cs]"]
  node_buildconfig_preprocess["Task preprocessing<br/>[Preprocessor.cs]"]
  node_buildconfig_verifier["Update verifier"]
end

node_pipeline(("Pipeline"))
node_appconfig_service["App Configuration"]
node_keyvault_service["Key Vault"]

node_pipeline -->|"runs tasks"| node_task_catalog
node_pipeline -->|"runs task"| node_appconfig_export
node_pipeline -->|"runs task"| node_appconfig_import
node_pipeline -->|"runs task"| node_appconfig_snapshot
node_pipeline -->|"runs task"| node_webapp_deploy
node_pipeline -->|"runs task"| node_function_deploy
node_pipeline -->|"runs task"| node_resource_deploy
node_pipeline -->|"runs task"| node_container_apps
node_pipeline -->|"runs task"| node_kubernetes_function
node_pipeline -->|"runs task"| node_iot_edge
node_pipeline -->|"runs task"| node_build_artifacts
node_pipeline -->|"runs task"| node_package_download
node_pipeline -->|"runs task"| node_github_release_download
node_pipeline -->|"runs task"| node_github_release_manage
node_pipeline -->|"runs task"| node_gradle_auth
node_appconfig_export -->|"reads settings"| node_appconfig_service
node_appconfig_export -->|"gets secrets"| node_keyvault_helper
node_keyvault_helper -->|"reads secrets"| node_keyvault_service
node_appconfig_import -->|"imports settings"| node_appconfig_service
node_appconfig_snapshot -->|"creates snapshot"| node_appconfig_service
node_build_artifacts -.-> node_buildconfig_program
node_buildconfig_program -->|"uses versions"| node_buildconfig_version
node_buildconfig_program -->|"uses Git utilities"| node_buildconfig_git
node_buildconfig_program -->|"preprocesses tasks"| node_buildconfig_preprocess
node_buildconfig_program -->|"checks updates"| node_buildconfig_verifier

click node_appconfig_export "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationExportV10/taskController.ts"
click node_appconfig_import "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationImportV10/taskController.ts"
click node_appconfig_snapshot "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationSnapshotV1/taskController.ts"
click node_keyvault_helper "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationExportV10/keyVaultClient.ts"
click node_webapp_deploy "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureRmWebAppDeploymentV5"
click node_function_deploy "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureFunctionAppV2"
click node_resource_deploy "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureResourceManagerTemplateDeploymentV3"
click node_container_apps "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureContainerAppsV1"
click node_kubernetes_function "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureFunctionOnKubernetesV1"
click node_iot_edge "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureIoTEdgeV2"
click node_build_artifacts "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadBuildArtifactsV0/main.ts"
click node_package_download "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadPackageV1/main.ts"
click node_github_release_download "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadGitHubReleaseV0/main.ts"
click node_github_release_manage "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/GitHubReleaseV1/main.ts"
click node_gradle_auth "https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/GradleAuthenticateV0/src/main.ts"
click node_task_catalog "https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks"
click node_buildconfig_program "https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/Program.cs"
click node_buildconfig_version "https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/TaskVersion.cs"
click node_buildconfig_git "https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/GitUtil.cs"
click node_buildconfig_preprocess "https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/Preprocessor.cs"
click node_buildconfig_verifier "https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/EnsureUpdateModeVerifier.cs"

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_task_catalog toneBlue
class node_appconfig_export,node_appconfig_import,node_appconfig_snapshot,node_keyvault_helper toneAmber
class node_webapp_deploy,node_function_deploy,node_resource_deploy,node_container_apps,node_kubernetes_function,node_iot_edge toneMint
class node_build_artifacts,node_package_download,node_github_release_download,node_github_release_manage,node_gradle_auth toneRose
class node_buildconfig_program,node_buildconfig_version,node_buildconfig_git,node_buildconfig_preprocess,node_buildconfig_verifier,node_pipeline,node_appconfig_service,node_keyvault_service toneIndigo
```

## Components

### Pipeline tasks

- [Other task runners](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks): `Tasks`

### App configuration

- [Export settings](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationExportV10/taskController.ts): `Tasks/AzureAppConfigurationExportV10/taskController.ts`
- [Import settings](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationImportV10/taskController.ts): `Tasks/AzureAppConfigurationImportV10/taskController.ts`
- [Create snapshot](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationSnapshotV1/taskController.ts): `Tasks/AzureAppConfigurationSnapshotV1/taskController.ts`
- [Key Vault client](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/AzureAppConfigurationExportV10/keyVaultClient.ts): `Tasks/AzureAppConfigurationExportV10/keyVaultClient.ts`

### Deployment and provisioning

- [Web app deployment](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureRmWebAppDeploymentV5): `Tasks/AzureRmWebAppDeploymentV5`
- [Function deployment](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureFunctionAppV2): `Tasks/AzureFunctionAppV2`
- [Resource deployment](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureResourceManagerTemplateDeploymentV3): `Tasks/AzureResourceManagerTemplateDeploymentV3`
- [Container Apps](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureContainerAppsV1): `Tasks/AzureContainerAppsV1`
- [Kubernetes functions](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureFunctionOnKubernetesV1): `Tasks/AzureFunctionOnKubernetesV1`
- [IoT Edge](https://github.com/microsoft/azure-pipelines-tasks/tree/master/Tasks/AzureIoTEdgeV2): `Tasks/AzureIoTEdgeV2`

### Artifacts and integrations

- [Build artifact download](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadBuildArtifactsV0/main.ts): `Tasks/DownloadBuildArtifactsV0/main.ts`
- [Package download](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadPackageV1/main.ts): `Tasks/DownloadPackageV1/main.ts`
- [GitHub release download](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/DownloadGitHubReleaseV0/main.ts): `Tasks/DownloadGitHubReleaseV0/main.ts`
- [GitHub release management](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/GitHubReleaseV1/main.ts): `Tasks/GitHubReleaseV1/main.ts`
- [Gradle authentication](https://github.com/microsoft/azure-pipelines-tasks/blob/master/Tasks/GradleAuthenticateV0/src/main.ts): `Tasks/GradleAuthenticateV0/src/main.ts`

### Configuration generation

- [Configuration coordinator](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/Program.cs): `BuildConfigGen/Program.cs`
- [Task versions](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/TaskVersion.cs): `BuildConfigGen/TaskVersion.cs`
- [Git utilities](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/GitUtil.cs): `BuildConfigGen/GitUtil.cs`
- [Task preprocessing](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/Preprocessor.cs): `BuildConfigGen/Preprocessor.cs`
- [Update verifier](https://github.com/microsoft/azure-pipelines-tasks/blob/master/BuildConfigGen/EnsureUpdateModeVerifier.cs): `BuildConfigGen/EnsureUpdateModeVerifier.cs`

### Other components

- **Pipeline**
- **App Configuration**
- **Key Vault**

## Connections

- Pipeline → Other task runners: runs tasks
- Pipeline → Export settings: runs task
- Pipeline → Import settings: runs task
- Pipeline → Create snapshot: runs task
- Pipeline → Web app deployment: runs task
- Pipeline → Function deployment: runs task
- Pipeline → Resource deployment: runs task
- Pipeline → Container Apps: runs task
- Pipeline → Kubernetes functions: runs task
- Pipeline → IoT Edge: runs task
- Pipeline → Build artifact download: runs task
- Pipeline → Package download: runs task
- Pipeline → GitHub release download: runs task
- Pipeline → GitHub release management: runs task
- Pipeline → Gradle authentication: runs task
- Export settings → App Configuration: reads settings (evidence: `Tasks/AzureAppConfigurationExportV10/taskController.ts`)
- Export settings → Key Vault client: gets secrets (evidence: `Tasks/AzureAppConfigurationExportV10/taskController.ts`)
- Key Vault client → Key Vault: reads secrets (evidence: `Tasks/AzureAppConfigurationExportV10/keyVaultClient.ts`)
- Import settings → App Configuration: imports settings (evidence: `Tasks/AzureAppConfigurationImportV10/taskController.ts`)
- Create snapshot → App Configuration: creates snapshot (evidence: `Tasks/AzureAppConfigurationSnapshotV1/taskController.ts`)
- Build artifact download → Configuration coordinator
- Configuration coordinator → Task versions: uses versions (evidence: `BuildConfigGen/Program.cs`)
- Configuration coordinator → Git utilities: uses Git utilities (evidence: `BuildConfigGen/Program.cs`)
- Configuration coordinator → Task preprocessing: preprocesses tasks (evidence: `BuildConfigGen/Program.cs`)
- Configuration coordinator → Update verifier: checks updates (evidence: `BuildConfigGen/Program.cs`)
