SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-deployment-environments

MicrosoftDocs

azure-deployment-environments

Expert knowledge for Azure Deployment Environments development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring ADE catalogs, RBAC/managed identities, Git/ARM catalogs, custom images, or CI/CD environment automation, and other Azure Deployment Environments related development tasks. Not for Azure DevTest Labs (use azure-devtest-labs), Azure Dev Box (use azure-dev-box), Azure Integration Environments (use azure-integration-environments), Azure Managed Applications (use azure-managed-applications).

v1.0Latest
New~2.0kUpdated Jun 26, 2026

Azure Deployment Environments Skill

This skill provides expert guidance for Azure Deployment Environments. 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-L41 Diagnosing and resolving custom image deployment failures in Azure Deployment Environments, including common error patterns, logs to inspect, and remediation steps.
Best Practices L42-L46 Guidance on organizing and structuring Azure Deployment Environments catalogs, including repo layout, template grouping, naming, and governance for scalable, maintainable catalogs.
Decision Making L47-L51 Guidance on planning for Azure Deployment Environments entering maintenance mode, including impact, timelines, alternatives, and migration/transition considerations.
Architecture & Design Patterns L52-L56 Guidance on designing resilient, scalable Azure Deployment Environments architectures, including fault tolerance, high availability, redundancy, and best practices for robust environment design.
Limits & Quotas L57-L61 Requesting and managing quota increases for Azure Deployment Environments resource limits, including how to handle capacity constraints and raise support requests.
Security L62-L69 RBAC and identity setup for Deployment Environments: planning and assigning roles, configuring managed identities, and authenticating to the REST APIs.
Configuration L70-L81 Defining ADE environments and types, configuring Git catalogs and ARM provisioning, using the devcenter CLI, auto-deletion, and environment variables for custom images.
Integrations & Coding Patterns L82-L88 Using Azure Developer CLI and ADE CLI to create environments, build custom container images, and manage custom image workflows for Azure Deployment Environments
Deployment L89-L93 Using Azure Deployment Environments with CI/CD tools (Azure Pipelines, GitHub Actions) to automate environment creation, updates, and deployments from templates.

Troubleshooting

Topic URL
Diagnose custom image deployment failures in Azure Deployment Environments https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors

Best Practices

Topic URL
Structure Azure Deployment Environments catalogs efficiently https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure

Decision Making

Topic URL
Plan for Azure Deployment Environments maintenance mode https://learn.microsoft.com/en-us/azure/deployment-environments/maintenance-mode

Architecture & Design Patterns

Topic URL
Design resilient Azure Deployment Environments architectures https://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments

Limits & Quotas

Topic URL
Request quota increases for ADE resource limits 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 https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate
Configure managed identity for Azure Deployment Environments dev center https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity
Assign RBAC roles for Azure Deployment Environments access https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access

Configuration

Topic URL
Define Azure Deployment Environments with environment.yaml schema https://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml
Configure Git-based catalogs for Azure Deployment Environments https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-catalog
Configure dev center environment types in Azure Deployment Environments https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-devcenter-environment-types
Configure project-level environment types in Azure Deployment Environments https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-project-environment-types
Install and use the devcenter Azure CLI extension https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-install-devcenter-cli-extension
Configure automatic deletion for ADE environments https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-schedule-environment-deletion
Provision dev center and project via ARM template https://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-dev-center-project-azure-resource-manager
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
Create ADE environments using Azure Developer CLI https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-azure-developer-cli-deployment-environments
Use custom container images with Azure Deployment Environments https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image
Use ADE CLI commands for custom image workflows https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli

Deployment

Topic URL
Integrate ADE with Azure Pipelines for CI/CD https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops
Deploy Azure environments via GitHub CI/CD pipelines https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

80

Quality

68

Clarity

78

Completeness

62

Summary

This skill provides expert guidance for Azure Deployment Environments (ADE), a service for managing development environments on Azure. It combines local quick-reference content with remote documentation fetching via Microsoft Learn APIs, covering troubleshooting, best practices, architecture patterns, security (RBAC, managed identities), configuration, integrations, and CI/CD deployment workflows. The skill functions primarily as a documentation index and navigation guide that directs agents to fetch comprehensive content from Microsoft Learn.

Detected Capabilities

Documentation fetching via HTTP (Microsoft Learn)Remote network request to mcp_microsoftdocs or fetch_webpageFile reading (SKILL.md content)Structured data organization (category index with URLs)

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

configure ade catalogsazure deployment environments setupade rbac identityazure environment ci/cdcustom image deploymentade troubleshootingdeployment environment quota

Risk Signals

INFO

Network requests to learn.microsoft.com for documentation

Compatibility section, Integrations & Coding Patterns section
INFO

Conditional tool availability (mcp_microsoftdocs fallback to fetch_webpage)

How to Use This Skill section
INFO

Time-based staleness check (metadata.generated_at validation)

IMPORTANT for Agent instruction

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Configure Azure Deployment Environments catalogs and templates
  • Set up RBAC and managed identity for ADE access control
  • Troubleshoot custom image deployment failures in ADE
  • Design resilient ADE architectures with high availability
  • Integrate ADE with Azure Pipelines or GitHub Actions for CI/CD
  • Manage environment quotas and request quota increases
  • Build custom container images for ADE using extensibility model
  • Plan ADE migration strategies for maintenance mode scenarios

Quality Notes

  • Strength: Clear category index with line ranges and descriptive section headers enables efficient navigation
  • Strength: Explicit fallback mechanisms documented for tool unavailability (mcp_microsoftdocs → fetch_webpage)
  • Strength: Metadata staleness check (3 months) prompts version updates
  • Strength: Scope is well-defined with clear exclusions (DevTest Labs, Dev Box, etc.)
  • Strength: Comprehensive coverage of 8 major ADE topics from troubleshooting to CI/CD
  • Weakness: Content references line ranges (L37-L41 etc.) but actual inline content is not present in SKILL.md—only a category index is provided
  • Weakness: No inline reference content; skill relies entirely on remote documentation fetches, reducing offline usability
  • Weakness: No examples of command syntax, API calls, or YAML configuration—agent must fetch documentation for concrete guidance
  • Weakness: No error handling patterns documented for failed documentation fetches or network failures
  • Weakness: Limits/quotas section exists but no guidance on quota request procedures or expected wait times
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-deployment-environments in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...