mcpField
A
azure-deployment-environments

azure-deployment-environments

github.com/microsoftdocsCloud & DevOps796170 installsUpdated 3d ago
Repository

About azure-deployment-environments

azure-deployment-environments is a guidance skill for developers and platform teams using Azure Deployment Environments. It pairs local references with remotely fetched documentation on setup, security, architecture, troubleshooting, and CI/CD deployment.

Key features

  1. 01Custom image deployment troubleshooting
  2. 02Catalog organization guidance
  3. 03Environment and catalog configuration
  4. 04RBAC and managed identity guidance
  5. 05CI/CD deployment references

Use cases

  1. 01Diagnosing custom image deployment failures
  2. 02Structuring reusable environment catalogs
  3. 03Configuring access and dev center identities
  4. 04Automating environment deployment with CI/CD

MCP support

The skill recommends the mcp_microsoftdocs microsoft_docs_fetch tool to retrieve documentation.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-deployment-environments

After installing, type/azure-deployment-environmentsin Claude Code to confirm it loaded.

Details

From the project README

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

CategoryLinesDescription
TroubleshootingL37-L41Diagnosing and resolving custom image deployment failures in Azure Deployment Environments, including common error patterns, logs to inspect, and remediation steps.
Best PracticesL42-L46Guidance on organizing and structuring Azure Deployment Environments catalogs, including repo layout, template grouping, naming, and governance for scalable, maintainable catalogs.
Decision MakingL47-L51Guidance on planning, executing, and managing the retirement or replacement of Azure Deployment Environments, including migration and decommissioning considerations.
Architecture & Design PatternsL52-L56Guidance on designing resilient, scalable Azure Deployment Environments architectures, including fault tolerance, high availability, redundancy, and best practices for robust environment design.
Limits & QuotasL57-L61Requesting and managing quota increases for Azure Deployment Environments resource limits, including how to handle capacity constraints and raise support requests.
SecurityL62-L69RBAC and identity setup for Deployment Environments: planning and assigning roles, configuring managed identities, and authenticating to the REST APIs.
ConfigurationL70-L82Defining environment.yaml, configuring dev centers/projects, catalogs, environment types, CLI/ARM setup, auto-deletion, and ADE CLI env vars for Azure Deployment Environments.
Integrations & Coding PatternsL83-L89Using Azure Developer CLI and ADE CLI to create environments, build custom container images, and manage custom image workflows for Azure Deployment Environments
DeploymentL90-L93Using Azure Deployment Environments with CI/CD tools (Azure Pipelines, GitHub Actions) to automate environment creation, updates, and deployments from templates.
Troubleshooting
TopicURL
Diagnose custom image deployment failures in Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors
Best Practices
TopicURL
Structure Azure Deployment Environments catalogs efficientlyhttps://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure
Decision Making
TopicURL
Plan retirement and replacement for Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/deployment-environments-retirement-guide
Architecture & Design Patterns
TopicURL
Design resilient Azure Deployment Environments architectureshttps://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments
Limits & Quotas
TopicURL
Request quota increases for ADE resource limitshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase
Security
TopicURL
Plan Azure RBAC roles for Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control
Authenticate to Azure Deployment Environments REST APIshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate
Configure managed identity for Azure Deployment Environments dev centerhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity
Assign RBAC roles for Azure Deployment Environments accesshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access
Configuration
TopicURL
Define Azure Deployment Environments with environment.yaml schemahttps://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml
Configure Git-based catalogs for Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-catalog
Configure dev center environment types in Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-devcenter-environment-types
Configure project-level environment types in Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-project-environment-types
Install and use the devcenter Azure CLI extensionhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-install-devcenter-cli-extension
Configure automatic deletion for ADE environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-schedule-environment-deletion
Configure dev centers and catalogs for Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-and-configure-devcenter
Provision dev centers and projects with ARM templateshttps://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-dev-center-project-azure-resource-manager
Reference ADE CLI environment variables for custom imageshttps://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables
Integrations & Coding Patterns
TopicURL
Create ADE environments using Azure Developer CLIhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-azure-developer-cli-deployment-environments
Use custom container images with Azure Deployment Environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image
Use ADE CLI commands for custom image workflowshttps://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli
Deployment
TopicURL
Integrate ADE with Azure Pipelines for CI/CDhttps://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops

Comments

Markdown supported