{"id":"d18b4a08-206a-4d2b-9a15-f420364d618b","shortId":"ymVxht","kind":"skill","title":"azure-deployment-environments","tagline":"Expert knowledge for Azure Deployment Environments development including troubleshooting, best practices, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when defining environment.yaml, configuring ADE catalogs, using ADE CLI, custom ","description":"# Azure Deployment Environments Skill\n\nThis 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.\n\n## How to Use This Skill\n\n> **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\n\n> **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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| 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. |\n| Best Practices | L40-L45 | Guidance on structuring ADE catalogs (repos, templates, parameters) and designing resilient, highly available deployment environments with Azure best practices. |\n| 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. |\n| 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. |\n| 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. |\n| 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 |\n| 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. |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Troubleshoot ADE custom image deployment errors | https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors |\n\n### Best Practices\n| Topic | URL |\n|-------|-----|\n| Apply catalog structure best practices in ADE | https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure |\n| Apply resiliency best practices in Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments |\n\n### Limits & Quotas\n| Topic | URL |\n|-------|-----|\n| Request ADE quota and capacity limit increases | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Plan Azure RBAC roles for Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control |\n| Authenticate to Azure Deployment Environments REST APIs securely | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate |\n| Configure managed identities for ADE deployments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity |\n| Assign ADE built-in roles and access scopes | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Configure environment.yaml schema for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml |\n| Configure ADE environment definitions and container images | https://learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition |\n| Configure custom container images in ADE extensibility | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image |\n| Reference ADE CLI environment variables for custom images | https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Use ADE CLI commands for custom image workflows | https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli |\n\n### Deployment\n| Topic | URL |\n|-------|-----|\n| Use Azure Pipelines to deploy ADE environments | https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops |\n| Integrate ADE with GitHub Actions CI/CD pipelines | https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github |","tags":["azure","deployment","environments","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions"],"capabilities":["skill","source-microsoftdocs","skill-azure-deployment-environments","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-deployment-environments","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (5,603 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:52.381Z","embedding":null,"createdAt":"2026-04-18T21:58:52.239Z","updatedAt":"2026-05-18T18:53:52.381Z","lastSeenAt":"2026-05-18T18:53:52.381Z","tsv":"'/en-us/azure/deployment-environments/best-practice-catalog-structure':423 '/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control':461 '/en-us/azure/deployment-environments/concept-environment-yaml':506 '/en-us/azure/deployment-environments/concept-reliability-deployment-environments':434 '/en-us/azure/deployment-environments/configure-environment-definition':516 '/en-us/azure/deployment-environments/how-to-authenticate':472 '/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image':526 '/en-us/azure/deployment-environments/how-to-configure-managed-identity':481 '/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access':493 '/en-us/azure/deployment-environments/how-to-request-quota-increase':448 '/en-us/azure/deployment-environments/reference-deployment-environment-cli':553 '/en-us/azure/deployment-environments/reference-deployment-environment-variables':537 '/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors':409 '/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops':566 '/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github':576 '/microsoftdocs/mcp/blob/main/readme.md)':161 '3':132 'accept':200 'access':166,308,489 'action':387,571 'ade':30,33,243,302,321,346,361,396,402,420,440,477,483,508,522,528,544,562,568 'agent':81,125,184,198 'api':295,468 'appli':414,424 'assign':301,482 'auth':296 'authent':462 'autom':356 'avail':151,252 'azur':2,8,36,46,216,256,268,335,376,383,429,453,464,501,558 'azure-deployment-environ':1 'best':14,51,235,257,410,417,426 'build':349 'building/using':325 'built':304,485 'built-in':303,484 'capabl':73 'capac':443 'catalog':31,244,415 'categori':84,92,108,204,206 'ci/cd':365,380,572 'cli':34,331,347,529,545 'code':21,58,226,339,539 'combin':63 'command':546 'common':224 'compat':233 'configur':19,29,56,230,297,313,320,389,473,494,497,507,517 'contain':327,512,519 'content':68,170 'control':309 'cover':49 'creat':392 'current':267 'custom':35,219,326,353,403,518,533,548 'default':273 'defin':27,317 'definit':323,510 'delet':395 'deploy':3,9,24,37,47,61,217,221,253,269,312,336,369,377,405,430,457,465,478,502,554,561 'descript':208 'design':249 'develop':11 'devop':367 'diagnos':213 'doc':176 'document':71,169 'e.g':96,112 'env':332 'environ':4,10,38,48,218,254,270,282,322,337,354,378,397,431,458,466,503,509,530,563 'environment.yaml':28,318,498 'error':225,406 'expert':5,43 'extens':523 'failur':222 'fallback':188 'fetch':72,168,177,190 'file':102,110,117,122 'github':386,570 'github.com':160 'github.com/microsoftdocs/mcp/blob/main/readme.md)':159 'guid':158 'guidanc':44,240 'high':251 'ident':299,475 'imag':220,232,328,355,357,362,404,513,520,534,549 'import':79,123 'includ':12,223,329,388 'increas':277,445 'index':85,205 'instal':155,157 'integr':20,57,338,360,375,538,567 'issu':228 'knowledg':6 'l120':99 'l35':98,211 'l35-l120':97 'l35-l39':210 'l39':212 'l40':238 'l40-l45':237 'l45':239 'l46':262 'l46-l50':261 'l50':263 'l51':287 'l51-l58':286 'l58':288 'l59':315 'l59-l66':314 'l66':316 'l67':342 'l67-l71':341 'l71':343 'l72':371 'l72-l76':370 'l76':372 'latest':140 'learn':183,197 'learn-agent-skil':182,196 'learn.microsoft.com':408,422,433,447,460,471,480,492,505,515,525,536,552,565,575 'learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure':421 'learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control':459 'learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml':504 'learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments':432 'learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition':514 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate':470 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image':524 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity':479 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access':491 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase':446 'learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli':551 'learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables':535 'learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors':407 'learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops':564 'learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github':574 'like':382 'limit':16,53,259,274,435,444 'line':94,106,207 'link':111,120 'local':64 'locat':88 'manag':298,352,474 'markdown':187,203 'mcp':146,173 'metadata.generated':127 'microsoft':175 'microsoftdoc':147,174 'month':133 'network':165 'old':134 'org':279 'paramet':247 'pattern':22,59,340,540 'pipelin':358,384,390,559,573 'plan':292,452 'practic':15,52,236,258,411,418,427 'prefer':171 'problem':234 'process':368 'project':280 'provid':42 'publish':350 'pull':138 'queri':179,193 'quick':66 'quick-refer':65 'quota':17,54,260,436,441 'quotas/capacity':271 'rang':95 'rbac':289,454 'read':101,116 'refer':67,121,527 'relev':89 'remot':70 'repo':245 'repositori':144 'request':276,439 'requir':164,330 'resili':250,425 'resolv':215 'resourc':283 'rest':294,467 'return':186,202 'role':291,455,487 'roles/scopes':306 'schema':319,499 'scope':490 'section':90 'secur':18,55,285,293,311,449,469 'security.md':113,114 'skill':39,41,78,163,185,199 'skill-azure-deployment-environments' 'source-microsoftdocs' 'specifi':105 'string':180,194 'structur':242,416 'suggest':135,152 'templat':246 'text/markdown':201 'tool':148,381 'topic':399,412,437,450,495,541,555 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'troubleshoot':13,50,209,398,401 'understand':272 'updat':393 'url':400,413,438,451,496,542,556 'usag':284 'use':25,32,76,82,100,115,172,189,344,543,557 'user':137,154 'valid':227 'var':333 'variabl':531 'version':141 'view':266 'webpag':191 'workflow':363,550","prices":[{"id":"03a89266-ec15-4e81-a290-afbe63a484b9","listingId":"d18b4a08-206a-4d2b-9a15-f420364d618b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:58:52.239Z"}],"sources":[{"listingId":"d18b4a08-206a-4d2b-9a15-f420364d618b","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-deployment-environments","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-deployment-environments","isPrimary":false,"firstSeenAt":"2026-04-18T21:58:52.239Z","lastSeenAt":"2026-05-18T18:53:52.381Z"}],"details":{"listingId":"d18b4a08-206a-4d2b-9a15-f420364d618b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-deployment-environments","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":549,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"b13d625948baef1d8aa6c43932771aff70455bdf","skill_md_path":"skills/azure-deployment-environments/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-deployment-environments"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-deployment-environments","description":"Expert knowledge for Azure Deployment Environments development including troubleshooting, best practices, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when defining environment.yaml, configuring ADE catalogs, using ADE CLI, custom images, or CI/CD pipelines, 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 Managed Applications (use azure-managed-applications), Azure Integration Environments (use azure-integration-environments).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-deployment-environments"},"updatedAt":"2026-05-18T18:53:52.381Z"}}