azure-pipelines

name	azure-pipelines
description	Expert knowledge for Azure Pipelines development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring YAML pipelines, self-hosted agents, service connections, Key Vault secrets, or Web App/Kubernetes deploys, and other Azure Pipelines related development tasks. Not for Azure DevOps (use azure-devops), Azure Boards (use azure-boards), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Pipelines Skill

This skill provides expert guidance for Azure Pipelines. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L47	Diagnosing and fixing Azure Pipelines issues: service connection/auth problems, web app deploy failures, triggers, stuck jobs, and using logs to debug run failures.
Best Practices	L48-L58	Best practices for faster, reliable pipelines: caching, cross-platform scripts, handling flaky tests, parallel test execution (incl. VSTest), Test Impact Analysis, and UI test configuration.
Decision Making	L59-L65	Guides for migrating CI/CD pipelines to Azure Pipelines, including from Jenkins/Travis and from classic UI pipelines to YAML, with patterns, pitfalls, and safe migration steps.
Architecture & Design Patterns	L66-L73	Guidance on end-to-end CI/CD and DevOps architectures for Azure: baseline pipeline patterns, Web App deployment design, and IaaS/VM-focused DevTest and production pipelines.
Limits & Quotas	L74-L82	Limits, quotas, and capacity for Azure Pipelines: hosted agent caps, image deprecation, parallel jobs, agent pool concurrency, large package handling, and retention policy configuration.
Security	L83-L135	Securing Azure Pipelines: agent auth, service connections, secrets/Key Vault, permissions and approvals, secure variables/files, repo access, signing, and integrating security scans/policies.
Configuration	L136-L462	Configuring Azure Pipelines: agents, YAML/classic triggers, stages/jobs/steps, variables, environments, artifacts, test/analytics, and detailed setup for built-in tasks and deployment strategies.
Integrations & Coding Patterns	L463-L492	Patterns and tasks for integrating Azure Pipelines with languages, tools, secrets, Git/GitHub, ServiceNow, Slack, Key Vault, and external APIs, plus caching and test automation.
Deployment	L493-L584	Agent setup and deployment guides for Azure Pipelines: installing/hosting agents, configuring CI/CD to VMs, App Service, containers, Kubernetes, databases, and publishing/consuming artifacts.

Troubleshooting

Topic	URL
Troubleshoot Azure Resource Manager service connections	https://learn.microsoft.com/en-us/azure/devops/pipelines/release/azure-rm-endpoint?view=azure-devops
Troubleshoot ARM workload identity service connections	https://learn.microsoft.com/en-us/azure/devops/pipelines/release/troubleshoot-workload-identity?view=azure-devops
Review Azure Pipelines logs for diagnostics	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/review-logs?view=azure-devops
Troubleshoot Azure Web App deployment tasks in pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/troubleshoot-azure-web-app-deploy?view=azure-devops
Fix Azure Pipelines jobs that never start	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/troubleshoot-start?view=azure-devops
Troubleshoot Azure Pipelines trigger issues	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/troubleshoot-triggers?view=azure-devops
Troubleshoot Azure Pipelines run failures using logs	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/troubleshooting?view=azure-devops

Best Practices

Topic	URL
Optimize Azure Pipelines performance with caching	https://learn.microsoft.com/en-us/azure/devops/pipelines/release/caching?view=azure-devops
Apply cross-platform scripting patterns in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/scripts/cross-platform-scripting?view=azure-devops
Manage flaky tests in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/test/flaky-test-management?view=azure-devops
Configure parallel test execution for any runner	https://learn.microsoft.com/en-us/azure/devops/pipelines/test/parallel-testing-any-test-runner?view=azure-devops
Run VSTest tests in parallel in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/test/parallel-testing-vstest?view=azure-devops
Use Test Impact Analysis in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/test/test-impact-analysis?view=azure-devops
Configure Azure Pipelines for UI test execution	https://learn.microsoft.com/en-us/azure/devops/pipelines/test/ui-testing-considerations?view=azure-devops

Decision Making

Topic	URL
Migrate from Jenkins to Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/migrate/from-jenkins?view=azure-devops
Migrate from Travis CI to Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/migrate/from-travis?view=azure-devops
Migrate Classic Azure Pipelines to YAML safely	https://learn.microsoft.com/en-us/azure/devops/pipelines/release/from-classic-pipelines?view=azure-devops

Architecture & Design Patterns

Topic	URL
Design CI/CD architecture for Azure Web Apps	https://learn.microsoft.com/en-us/azure/devops/pipelines/architectures/devops-pipelines-azure-web-apps-architecture?view=azure-devops
Adopt baseline Azure Pipelines CI/CD architecture	https://learn.microsoft.com/en-us/azure/devops/pipelines/architectures/devops-pipelines-baseline-architecture?view=azure-devops
Architect DevTest and DevOps pipelines for IaaS	https://learn.microsoft.com/en-us/azure/devops/pipelines/architectures/devops-pipelines-devtest-iaas-architecture?view=azure-devops
DevOps architecture for IaaS applications with VMs	https://learn.microsoft.com/en-us/azure/devops/pipelines/architectures/devops-pipelines-iaas-vms-architecture?view=azure-devops

Limits & Quotas

Topic	URL
Track deprecation schedule for hosted build images	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/hosted-deprecation-schedule?view=azure-devops
Understand Microsoft-hosted agent limits in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/hosted?view=azure-devops
Analyze Azure Pipelines agent pool concurrency	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/pool-consumption-report?view=azure-devops
Publish and download large Universal Packages	https://learn.microsoft.com/en-us/azure/devops/pipelines/artifacts/universal-packages?view=azure-devops
Configure and purchase Azure Pipelines parallel jobs	https://learn.microsoft.com/en-us/azure/devops/pipelines/licensing/concurrent-jobs?view=azure-devops

Security

Topic	URL
Choose authentication options for self-hosted agents	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/agent-authentication-options?view=azure-devops
Run Azure Pipelines agent with self-signed certificate	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/certificate?view=azure-devops-server
Register Azure Pipelines agent using device code flow	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/device-code-flow-agent-registration?view=azure-devops
Register Azure Pipelines agent using PAT authentication	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/personal-access-token-agent-registration?view=azure-devops
Register Azure Pipelines agent with service principal	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/service-principal-agent-registration?view=azure-devops
Securely sign mobile apps in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/mobile/app-signing?view=azure-devops
Configure Docker Content Trust signing in Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/containers/content-trust?view=azure-devops
Secure Azure DevOps pipelines with Entra workload identities	https://learn.microsoft.com/en-us/azure/devops/pipelines/library/add-devops-entra-service-connection?view=azure-devops
Assign administrators for protected pipeline resources	https://learn.microsoft.com/en-us/azure/devops/pipelines/library/add-resource-protection?view=azure-devops

Configuration

Topic	URL
Choose and configure Azure Pipelines agents	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/agents?view=azure-devops
Configure Node.js runners in Azure Pipelines agent	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/nodejs-runners?view=azure-devops
Configure Azure Pipelines agent behind web proxy	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/proxy?view=azure-devops
Publish and download build artifacts in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/artifacts/build-artifacts?view=azure-devops
Publish and download pipeline artifacts in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/artifacts/pipeline-artifacts?view=azure-devops
Use tasks and leases to retain Azure Pipelines runs	https://learn.microsoft.com/en-us/azure/devops/pipelines/build/run-retention?view=azure-devops
Reference predefined Azure Pipelines variables	https://learn.microsoft.com/en-us/azure/devops/pipelines/build/variables?view=azure-devops
Configure Azure Pipelines and releases retention policies	https://learn.microsoft.com/en-us/azure/devops/pipelines/policies/retention?view=azure-devops
Configure conditions for Azure Pipelines stages, jobs, and steps	https://learn.microsoft.com/en-us/azure/devops/pipelines/process/conditions?view=azure-devops
Configure container jobs in Azure Pipelines YAML	https://learn.microsoft.com/en-us/azure/devops/pipelines/process/container-phases?view=azure-devops

Integrations & Coding Patterns

Topic	URL
Build Azure CI/CD data pipeline with ML training	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/cd/azure/build-data-pipeline?view=azure-devops
Cache NuGet packages with Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/artifacts/caching-nuget?view=azure-devops
Use Anaconda environments in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/anaconda?view=azure-devops
Customize Azure Pipelines for JavaScript projects	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/customize-javascript?view=azure-devops
Customize Azure Pipelines for Python applications	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/customize-python?view=azure-devops
Configure Azure Pipelines for Java builds	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/java?view=azure-devops
Build and deploy Xcode apps with Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/xcode?view=azure-devops
Integrate Azure Pipelines notifications with Slack	https://learn.microsoft.com/en-us/azure/devops/pipelines/integrations/slack?view=azure-devops
Use Invoke Azure Function/REST API checks in pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/process/invoke-checks?view=azure-devops
Set Azure Pipelines variables from scripts	https://learn.microsoft.com/en-us/azure/devops/pipelines/process/set-variables-scripts?view=azure-devops

Deployment

Topic	URL
Run Azure Pipelines self-hosted agent in Docker	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/docker?view=azure-devops
Deploy Azure Pipelines self-hosted agent on Linux	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/linux-agent?view=azure-devops
Deploy Azure Pipelines agent on macOS	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/osx-agent?view=azure-devops
Use VM scale set agents for Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/scale-set-agents?view=azure-devops
Run and migrate Azure Pipelines agent v3	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/v3-agent?view=azure-devops
Upgrade and run Azure Pipelines agent v4	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/v4-agent?view=azure-devops
Deploy Azure Pipelines agent on Windows	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/windows-agent?view=azure-devops
Build ASP.NET apps with .NET Framework in Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/aspnet/build-aspnet-4?view=azure-devops
Deploy Linux web app with ARM template via pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/cd/azure/deploy-arm-template?view=azure-devops
Deploy containerized web apps to Azure App Service	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/cd/deploy-docker-webapp?view=azure-devops