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 CI/CD, agents, service connections, Key Vault secrets, or deploying to Web Apps/Kubernetes, and other Azure Pipelines related development tasks. Not for Azure DevOps (use azure-devops), Azure Test Plans (use azure-test-plans), Azure Boards (use azure-boards), Azure Repos (use azure-repos).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","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 errors, triggers not firing, runs not starting, log analysis, and deployment failures (especially Azure Web Apps).
Best Practices	L48-L59	Guidance on YAML template design, caching for faster builds, cross-platform scripts, and best practices for configuring, parallelizing, and stabilizing automated tests (including UI and VSTest).
Decision Making	L60-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-L85	Managing Azure Pipelines limits: agent quotas/concurrency, Microsoft/GitHub-hosted agent capabilities, image deprecations, parallel jobs, run retention, and large Universal Package handling.
Security	L86-L137	Securing Azure Pipelines: auth for agents, service connections, secrets/Key Vault, permissions, approvals/checks, secure variables, CodeQL/dependency scanning, and policy/compliance controls.
Configuration	L138-L501	Configuring Azure Pipelines: agents, triggers, environments, YAML schema, variables, deployment strategies, and detailed task/step options for builds, tests, and deployments.
Integrations & Coding Patterns	L502-L530	Language-specific CI/CD pipeline examples, scripting patterns, and integrations (Git, Key Vault, Slack, ServiceNow, REST/Functions, Selenium) for building, testing, and automating Azure Pipelines.
Deployment	L531-L589	Deploying apps and packages with Azure Pipelines: agent setup (Windows/Linux/macOS/containers), artifacts (NuGet/npm/Maven/etc.), and deployment to VMs, web apps, Kubernetes, SQL, and Azure resources.

Troubleshooting

Topic	URL
Troubleshoot Azure Resource Manager service connections in Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/release/azure-rm-endpoint?view=azure-devops
Troubleshoot ARM workload identity service connections in pipelines	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
Troubleshoot Azure Pipelines that fail to 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
Diagnose and fix Azure Pipelines run failures	https://learn.microsoft.com/en-us/azure/devops/pipelines/troubleshooting/troubleshooting?view=azure-devops

Best Practices

Topic	URL
Design and use Azure Pipelines YAML templates	https://learn.microsoft.com/en-us/azure/devops/pipelines/process/templates?view=azure-devops
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 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
Review GitHub-hosted agents quotas and FAQs for Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/github-hosted-faq?view=azure-devops
Plan usage and limits for GitHub-hosted agents in Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/github-hosted?view=azure-devops
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 and capabilities	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 estimate Azure Pipelines parallel jobs	https://learn.microsoft.com/en-us/azure/devops/pipelines/licensing/concurrent-jobs?view=azure-devops
Configure Azure Pipelines run retention limits	https://learn.microsoft.com/en-us/azure/devops/pipelines/policies/retention?view=azure-devops

Security

Topic	URL
Choose and configure auth methods 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 agents with a 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
Manage and configure Azure Pipelines v4 agents	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/v4-agent?view=azure-devops
Configure and run Azure Pipelines v5 agents	https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/v5-agent?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
Configure trigger settings for Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/build/triggers?view=azure-devops
Reference predefined Azure Pipelines variables	https://learn.microsoft.com/en-us/azure/devops/pipelines/build/variables?view=azure-devops

Integrations & Coding Patterns

Topic	URL
Build ASP.NET .NET Framework apps in Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/apps/aspnet/build-aspnet-4?view=azure-devops
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
Configure NuGet package caching in 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 Python CI/CD pipelines in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/customize-python?view=azure-devops
Build and deploy .NET Core apps with Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/dotnet-core?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 test Python apps with Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/python?view=azure-devops
Build and test Ruby applications with Azure Pipelines	https://learn.microsoft.com/en-us/azure/devops/pipelines/ecosystems/ruby?view=azure-devops