Back to Details

azure-deployment-environments

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Azure Deployment Environments Skill

Azure Deployment Environments 技能

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.
本技能为Azure Deployment Environments提供专业指导，涵盖故障排除、最佳实践、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。

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.
Agent 注意事项：使用下方的分类索引查找相关章节。对于带有行范围的分类（例如 
L35-L120
），使用
read_file
读取指定行。对于带有文件链接的分类（例如 
[security.md](security.md)
），使用
read_file
读取链接的参考文件
Agent 注意事项：如果
metadata.generated_at
已超过3个月，建议用户从仓库拉取最新版本。如果
mcp_microsoftdocs
工具不可用，建议用户安装它：安装指南
本技能需要网络访问权限以获取文档内容：
  • 首选方式：使用
    mcp_microsoftdocs:microsoft_docs_fetch
    ，查询字符串为
    from=learn-agent-skill
    ，返回Markdown格式内容。
  • 备用方式：使用
    fetch_webpage
    ，查询字符串为
    from=learn-agent-skill&accept=text/markdown
    ，返回Markdown格式内容。

Category Index

分类索引

CategoryLinesDescription
TroubleshootingL35-L39Diagnosing and resolving Azure Deployment Environments custom image deployment failures, including common error codes, validation issues, and configuration or image compatibility problems.
Best PracticesL40-L44Guidance on structuring ADE catalogs: organizing templates, folders, and repos for reusable, maintainable, and scalable deployment environment definitions.
Limits & QuotasL45-L49How to view current Azure Deployment Environments quotas/capacity, understand default limits, and request increases for org, project, and environment resource usage.
SecurityL50-L57RBAC and identity for ADE: planning Azure roles/scopes, using Azure CLI auth for REST, configuring managed identities, and assigning built‑in ADE roles and access.
ConfigurationL58-L65Defining and configuring ADE environment.yaml schemas, environment definitions, and custom container images, plus required CLI environment variables for building and running those images.
Integrations & Coding PatternsL66-L70Using 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
DeploymentL71-L75How 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.
分类行范围描述
故障排除L35-L39诊断并解决Azure Deployment Environments自定义镜像部署失败问题，包括常见错误代码、验证问题以及配置或镜像兼容性问题。
最佳实践L40-L44关于构建ADE目录的指导：组织模板、文件夹和仓库，以实现可复用、可维护且可扩展的部署环境定义。
限制与配额L45-L49如何查看当前Azure Deployment Environments的配额/容量，了解默认限制，并为组织、项目和环境资源使用申请配额提升。
安全L50-L57ADE的RBAC与身份管理：规划Azure角色/范围，使用Azure CLI进行REST认证，配置托管身份，以及分配内置ADE角色和权限。
配置L58-L65定义并配置ADE的environment.yaml架构、环境定义和自定义容器镜像，以及构建和运行这些镜像所需的CLI环境变量。
集成与编码模式L66-L70使用ADE CLI构建、发布和管理自定义环境镜像，自动化镜像管道，并将ADE镜像工作流集成到CI/CD和DevOps流程中
部署L71-L75如何将Azure Deployment Environments与Azure Pipelines、GitHub Actions等CI/CD工具集成，包括配置管道以创建、更新和删除ADE环境。

Troubleshooting

故障排除

TopicURL
Troubleshoot ADE custom image deployment errorshttps://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors
主题链接
排查ADE自定义镜像部署错误https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors

Best Practices

最佳实践

TopicURL
Apply catalog structure best practices in ADEhttps://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure
主题链接
在ADE中应用目录结构最佳实践https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure

Limits & Quotas

限制与配额

TopicURL
Request ADE quota and capacity limit increaseshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase
主题链接
申请ADE配额和容量限制提升https://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 ADE REST APIs using Azure CLIhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate
Configure managed identities for ADE deploymentshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity
Assign ADE built-in roles and access scopeshttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access
主题链接
为Deployment Environments规划Azure RBAC角色https://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control
使用Azure CLI认证ADE REST APIhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate
为ADE部署配置托管身份https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity
分配ADE内置角色和权限范围https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access

Configuration

配置

TopicURL
Configure environment.yaml schema for ADE definitionshttps://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml
Configure ADE environment definitions and container imageshttps://learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition
Configure custom container images in ADE extensibilityhttps://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image
Reference ADE CLI environment variables for custom imageshttps://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables
主题链接
为ADE定义配置environment.yaml架构https://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml
配置ADE环境定义和容器镜像https://learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition
在ADE可扩展性中配置自定义容器镜像https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image
参考ADE CLI自定义镜像的环境变量https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables

Integrations & Coding Patterns

集成与编码模式

TopicURL
Use ADE CLI commands for custom image workflowshttps://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli
主题链接
使用ADE CLI命令执行自定义镜像工作流https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli

Deployment

部署

TopicURL
Use Azure Pipelines to deploy ADE environmentshttps://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops
Integrate ADE with GitHub Actions CI/CD pipelineshttps://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github
主题链接
使用Azure Pipelines部署ADE环境https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops
将ADE与GitHub Actions CI/CD管道集成https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github