Azure Deployment Environments Skill

This skill provides expert guidance for Azure Deployment Environments. Covers troubleshooting, best practices, 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	L35-L39	Diagnosing and resolving Azure Deployment Environments custom image deployment failures, including common error codes, validation issues, and configuration or image compatibility problems.
Best Practices	L40-L45	Guidance on structuring ADE catalogs (repos, templates, parameters) and designing resilient, highly available deployment environments with Azure best practices.
Limits & Quotas	L46-L50	How to view current Azure Deployment Environments quotas/capacity, understand default limits, and request increases for org, project, and environment resource usage.
Security	L51-L58	RBAC and role planning, secure REST API auth, configuring managed identities, and assigning ADE built-in roles/scopes for access control and secure deployments.
Configuration	L59-L66	Defining environment.yaml schemas, configuring ADE environment definitions, and building/using custom container images (including required CLI env vars) for Azure Deployment Environments.
Integrations & Coding Patterns	L67-L71	Using the ADE CLI to build, publish, and manage custom environment images, automate image pipelines, and integrate ADE image workflows into CI/CD and DevOps processes
Deployment	L72-L76	How to integrate Azure Deployment Environments with CI/CD tools like Azure Pipelines and GitHub Actions, including configuring pipelines to create, update, and delete ADE environments.

Troubleshooting

Topic	URL
Troubleshoot ADE custom image deployment errors	https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors

Best Practices

Topic	URL
Apply catalog structure best practices in ADE	https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure
Apply resiliency best practices in Azure Deployment Environments	https://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments

Limits & Quotas

Topic	URL
Request ADE quota and capacity limit increases	https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase

Security

Topic	URL
Plan Azure RBAC roles for Deployment Environments	https://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control
Authenticate to Azure Deployment Environments REST APIs securely	https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate
Configure managed identities for ADE deployments	https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity
Assign ADE built-in roles and access scopes	https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access

Configuration

Topic	URL
Configure environment.yaml schema for Azure Deployment Environments	https://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml
Configure ADE environment definitions and container images	https://learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition
Configure custom container images in ADE extensibility	https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image
Reference ADE CLI environment variables for custom images	https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables

Integrations & Coding Patterns

Topic	URL
Use ADE CLI commands for custom image workflows	https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli

Deployment

Topic	URL
Use Azure Pipelines to deploy ADE environments	https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops
Integrate ADE with GitHub Actions CI/CD pipelines	https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github