{"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 designing ADE catalogs, environment.yaml schemas, custom images, RBAC/roles","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-L44 | Guidance on structuring ADE catalogs: organizing templates, folders, and repos for reusable, maintainable, and scalable deployment environment definitions. |\n| Limits & Quotas | L45-L49 | How to view current Azure Deployment Environments quotas/capacity, understand default limits, and request increases for org, project, and environment resource usage. |\n| Security | L50-L57 | RBAC 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. |\n| Configuration | L58-L65 | Defining and configuring ADE environment.yaml schemas, environment definitions, and custom container images, plus required CLI environment variables for building and running those images. |\n| Integrations & Coding Patterns | L66-L70 | 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 | L71-L75 | 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\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 ADE REST APIs using Azure CLI | 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 ADE definitions | 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.698","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 497 github stars · SKILL.md body (5,389 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-04-22T06:53:31.502Z","embedding":null,"createdAt":"2026-04-18T21:58:52.239Z","updatedAt":"2026-04-22T06:53:31.502Z","lastSeenAt":"2026-04-22T06:53:31.502Z","tsv":"'/en-us/azure/deployment-environments/best-practice-catalog-structure':424 '/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control':451 '/en-us/azure/deployment-environments/concept-environment-yaml':495 '/en-us/azure/deployment-environments/configure-environment-definition':505 '/en-us/azure/deployment-environments/how-to-authenticate':462 '/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image':515 '/en-us/azure/deployment-environments/how-to-configure-managed-identity':471 '/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access':483 '/en-us/azure/deployment-environments/how-to-request-quota-increase':438 '/en-us/azure/deployment-environments/reference-deployment-environment-cli':542 '/en-us/azure/deployment-environments/reference-deployment-environment-variables':526 '/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors':410 '/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops':555 '/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github':565 '/microsoftdocs/mcp/blob/main/readme.md)':160 '3':131 'accept':199 'access':165,311,479 'action':388,560 'ade':28,242,291,308,319,347,362,397,403,421,430,454,467,473,491,497,511,517,533,551,557 'agent':80,124,183,197 'api':456 'appli':415 'assign':305,472 'auth':298 'authent':452 'autom':357 'avail':150 'azur':2,8,35,45,215,266,293,296,377,384,443,458,547 'azure-deployment-environ':1 'best':14,50,234,411,418 'build':334,350 'built':306,475 'built-in':474 'capabl':72 'capac':433 'catalog':29,243,416 'categori':83,91,107,203,205 'ci/cd':366,381,561 'cli':297,330,348,459,518,534 'code':21,57,225,340,528 'combin':62 'command':535 'common':223 'compat':232 'configur':19,55,229,301,312,318,390,463,484,487,496,506 'contain':326,501,508 'content':67,169 'cover':48 'creat':393 'current':265 'custom':32,218,325,354,404,507,522,537 'default':271 'defin':316 'definit':256,323,492,499 'delet':396 'deploy':3,9,24,36,46,60,216,220,254,267,370,378,406,447,468,543,550 'descript':207 'design':27 'develop':11 'devop':368 'diagnos':212 'doc':175 'document':70,168 'e.g':95,111 'environ':4,10,37,47,217,255,268,280,322,331,355,379,398,448,498,519,552 'environment.yaml':30,320,488 'error':224,407 'expert':5,42 'extens':512 'failur':221 'fallback':187 'fetch':71,167,176,189 'file':101,109,116,121 'folder':246 'github':387,559 'github.com':159 'github.com/microsoftdocs/mcp/blob/main/readme.md)':158 'guid':157 'guidanc':43,239 'ident':289,303,465 'imag':33,219,231,327,338,356,358,363,405,502,509,523,538 'import':78,122 'includ':12,222,389 'increas':275,435 'index':84,204 'instal':154,156 'integr':20,56,339,361,376,527,556 'issu':227 'knowledg':6 'l120':98 'l35':97,210 'l35-l120':96 'l35-l39':209 'l39':211 'l40':237 'l40-l44':236 'l44':238 'l45':260 'l45-l49':259 'l49':261 'l50':285 'l50-l57':284 'l57':286 'l58':314 'l58-l65':313 'l65':315 'l66':343 'l66-l70':342 'l70':344 'l71':372 'l71-l75':371 'l75':373 'latest':139 'learn':182,196 'learn-agent-skil':181,195 'learn.microsoft.com':409,423,437,450,461,470,482,494,504,514,525,541,554,564 'learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure':422 'learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control':449 'learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml':493 'learn.microsoft.com/en-us/azure/deployment-environments/configure-environment-definition':503 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate':460 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image':513 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity':469 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access':481 'learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase':436 'learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli':540 'learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables':524 'learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors':408 'learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops':553 'learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-github':563 'like':383 'limit':16,52,257,272,425,434 'line':93,105,206 'link':110,119 'local':63 'locat':87 'maintain':251 'manag':302,353,464 'markdown':186,202 'mcp':145,172 'metadata.generated':126 'microsoft':174 'microsoftdoc':146,173 'month':132 'network':164 'old':133 'org':277 'organ':244 'pattern':22,58,341,529 'pipelin':359,385,391,548,562 'plan':292,442 'plus':328 'practic':15,51,235,412,419 'prefer':170 'problem':233 'process':369 'project':278 'provid':41 'publish':351 'pull':137 'queri':178,192 'quick':65 'quick-refer':64 'quota':17,53,258,426,431 'quotas/capacity':269 'rang':94 'rbac':287,444 'rbac/roles':34 'read':100,115 'refer':66,120,516 'relev':88 'remot':69 'repo':248 'repositori':143 'request':274,429 'requir':163,329 'resolv':214 'resourc':281 'rest':300,455 'return':185,201 'reusabl':250 'role':309,445,477 'roles/scopes':294 'run':336 'scalabl':253 'schema':31,321,489 'scope':480 'section':89 'secur':18,54,283,439 'security.md':112,113 'skill':38,40,77,162,184,198 'skill-azure-deployment-environments' 'source-microsoftdocs' 'specifi':104 'string':179,193 'structur':241,417 'suggest':134,151 'templat':245 'text/markdown':200 'tool':147,382 'topic':400,413,427,440,485,530,544 '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,49,208,399,402 'understand':270 'updat':394 'url':401,414,428,441,486,531,545 'usag':282 'use':25,75,81,99,114,171,188,295,345,457,532,546 'user':136,153 'valid':226 'variabl':332,520 'version':140 'view':264 'webpag':190 'workflow':364,539","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-04-22T06:53:31.502Z"}],"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":497,"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-04-22T01:37:27Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"27ffff370c42b5ecc0060960b3a3273bc1f44091","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 designing ADE catalogs, environment.yaml schemas, custom images, RBAC/roles, or CI/CD image 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 Integration Environments (use azure-integration-environments), Azure Managed Applications (use azure-managed-applications).","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-04-22T06:53:31.502Z"}}