使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-deployment-environments开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: Ifmetadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=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, executing, and managing the retirement or replacement of Azure Deployment Environments, including migration and decommissioning 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-L82 | Defining 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 Patterns | L83-L89 | Using Azure Developer CLI and ADE CLI to create environments, build custom container images, and manage custom image workflows for Azure Deployment Environments |
| Deployment | L90-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 retirement and replacement for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/deployment-environments-retirement-guide |
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 |
| Configure dev centers and catalogs for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-and-configure-devcenter |
| Provision dev centers and projects with ARM templates | 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 |
