{"id":"91e43b10-b03d-4b97-b046-b55039712e88","shortId":"sT87TP","kind":"skill","title":"azure-operator-service-manager","tagline":"Expert knowledge for Azure Operator Service Manager development including troubleshooting, best practices, security, configuration, and integrations & coding patterns. Use when onboarding CNFs/VNFs, designing config groups, using ACR-backed artifacts, Private Link, or AOSM CLI, a","description":"# Azure Operator Service Manager Skill\n\nThis skill provides expert guidance for Azure Operator Service Manager. Covers troubleshooting, best practices, security, configuration, and integrations & coding patterns. 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 | L33-L38 | Diagnosing and fixing AOSM onboarding issues with the Azure CLI extension and troubleshooting Helm chart installation failures in AOSM CNF deployments. |\n| Best Practices | L39-L47 | Best practices for AOSM onboarding, config group design, Helm chart usage, artifact cleanup, and controlling CNF upgrade behavior and failure handling |\n| Security | L48-L55 | Securing AOSM with Private Link, custom RBAC/roles, and User Assigned Managed Identities for controlled, least-privilege access and secure SNS/service operator deployments. |\n| Configuration | L56-L65 | Configuring AOSM runtime behavior: cluster registry for edge resiliency, pausing/resuming deployments, Helm cleanup/test settings, NFO extension cluster commands, and geo-replicated artifact stores. |\n| Integrations & Coding Patterns | L66-L75 | Using CLI/ARM/Helm with AOSM to onboard CNFs/VNFs, manage images and artifacts (ACR/storage-backed stores), and add ARM resources to network service designs |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Troubleshoot Azure CLI AOSM extension onboarding issues | https://learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-cli-common-issues |\n| Diagnose Helm install failures in AOSM CNF deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-helm-install-failures |\n\n### Best Practices\n| Topic | URL |\n|-------|-----|\n| Apply onboarding and deployment best practices for AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/best-practices-onboard-deploy |\n| Design configuration groups effectively in Azure Operator Service Manager | https://learn.microsoft.com/en-us/azure/operator-service-manager/configuration-guide |\n| Implement Helm chart best practices for AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/helm-requirements |\n| Manage AOSM publisher artifact cleanup efficiently | https://learn.microsoft.com/en-us/azure/operator-service-manager/resource-cleanup-management |\n| Control CNF upgrade failure behavior in AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-nf-level-rollback |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Configure AOSM Private Link for secure backhaul | https://learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-private-link |\n| Assign custom AOSM roles for secure SNS deployment | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-assign-custom-role |\n| Create custom RBAC roles for AOSM service operators | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-custom-role |\n| Configure and use User Assigned Managed Identity with AOSM | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-user-assigned-managed-identity |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Set up AOSM cluster registry for edge resiliency | https://learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-cluster-registry |\n| Interrupt and resume AOSM site network service deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-cancel-service-deployments |\n| Override Helm failure cleanup behavior in AOSM deployments | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-use-helm-option-parameters |\n| Use AOSM NFO extension commands to manage clusters | https://learn.microsoft.com/en-us/azure/operator-service-manager/manage-network-function-operator |\n| Configure geo-replication for AOSM artifact stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/publisher-artifact-store-resiliency |\n| Configure Helm test integration for AOSM upgrades | https://learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-helm-test |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Use AOSM CLI to discover and upload CNF images | https://learn.microsoft.com/en-us/azure/operator-service-manager/concepts-cli-containerized-network-function-image-upload |\n| Map Helm and ARM parameters to AOSM configuration | https://learn.microsoft.com/en-us/azure/operator-service-manager/concepts-expose-parameters-configuration-group-schema |\n| Push and pull artifacts with ACR-backed AOSM artifact stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-nexus |\n| Push and pull artifacts with AOSM storage-backed stores | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-virtualized-network-function-cloud |\n| Add ARM resources to AOSM Network Service Designs via CLI | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-azure-resource-manager-resources-cli |\n| Onboard CNFs to AOSM using the CLI extension | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-containerized-network-function-cli |\n| Onboard VNFs to AOSM for deployment on Nexus | https://learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-virtualized-network-function-cli |","tags":["azure","operator","service","manager","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding"],"capabilities":["skill","source-microsoftdocs","skill-azure-operator-service-manager","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-operator-service-manager","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 (6,442 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-22T00:53:35.105Z","embedding":null,"createdAt":"2026-04-18T21:59:39.869Z","updatedAt":"2026-04-22T00:53:35.105Z","lastSeenAt":"2026-04-22T00:53:35.105Z","tsv":"'/en-us/azure/operator-service-manager/best-practices-onboard-deploy':385 '/en-us/azure/operator-service-manager/concepts-cli-containerized-network-function-image-upload':558 '/en-us/azure/operator-service-manager/concepts-expose-parameters-configuration-group-schema':569 '/en-us/azure/operator-service-manager/configuration-guide':397 '/en-us/azure/operator-service-manager/get-started-with-cluster-registry':487 '/en-us/azure/operator-service-manager/get-started-with-private-link':439 '/en-us/azure/operator-service-manager/helm-requirements':407 '/en-us/azure/operator-service-manager/how-to-assign-custom-role':450 '/en-us/azure/operator-service-manager/how-to-cancel-service-deployments':498 '/en-us/azure/operator-service-manager/how-to-create-custom-role':461 '/en-us/azure/operator-service-manager/how-to-create-user-assigned-managed-identity':473 '/en-us/azure/operator-service-manager/how-to-manage-artifacts-nexus':583 '/en-us/azure/operator-service-manager/how-to-manage-artifacts-virtualized-network-function-cloud':596 '/en-us/azure/operator-service-manager/how-to-onboard-azure-resource-manager-resources-cli':609 '/en-us/azure/operator-service-manager/how-to-onboard-containerized-network-function-cli':620 '/en-us/azure/operator-service-manager/how-to-onboard-virtualized-network-function-cli':631 '/en-us/azure/operator-service-manager/how-to-use-helm-option-parameters':509 '/en-us/azure/operator-service-manager/manage-network-function-operator':520 '/en-us/azure/operator-service-manager/publisher-artifact-store-resiliency':531 '/en-us/azure/operator-service-manager/resource-cleanup-management':416 '/en-us/azure/operator-service-manager/safe-upgrades-helm-test':541 '/en-us/azure/operator-service-manager/safe-upgrades-nf-level-rollback':426 '/en-us/azure/operator-service-manager/troubleshoot-cli-common-issues':359 '/en-us/azure/operator-service-manager/troubleshoot-helm-install-failures':370 '/microsoftdocs/mcp/blob/main/readme.md)':166 '3':137 'accept':205 'access':171,286 'acr':33,576 'acr-back':32,575 'acr/storage-backed':337 'add':340,597 'agent':86,130,189,203 'aosm':39,221,236,247,270,297,329,353,365,382,404,409,423,431,442,456,470,479,491,505,511,526,537,548,565,578,589,601,613,624 'appli':375 'arm':341,562,598 'artifact':35,255,318,336,411,527,573,579,587 'assign':278,440,466 'avail':156 'azur':2,9,42,53,226,351,391 'azure-operator-service-manag':1 'back':34,577,592 'backhaul':436 'behavior':261,299,421,503 'best':16,59,239,244,371,379,401 'capabl':78 'categori':89,97,113,209,211 'chart':232,253,400 'cleanup':256,412,502 'cleanup/test':308 'cli':40,227,352,549,606,616 'cli/arm/helm':327 'cluster':300,312,480,517 'cnf':237,259,366,418,554 'cnfs':611 'cnfs/vnfs':27,332 'code':22,65,321,543 'combin':68 'command':313,514 'config':29,249 'configur':19,62,292,296,387,430,462,474,521,532,566 'content':73,175 'control':258,282,417 'cover':57 'creat':451 'custom':274,441,452 'deploy':238,291,306,367,378,447,495,506,626 'descript':213 'design':28,251,346,386,604 'develop':13 'diagnos':218,360 'discov':551 'doc':181 'document':76,174 'e.g':101,117 'edg':303,483 'effect':389 'effici':413 'expert':6,50 'extens':228,311,354,513,617 'failur':234,263,363,420,501 'fallback':193 'fetch':77,173,182,195 'file':107,115,122,127 'fix':220 'geo':316,523 'geo-repl':315,522 'github.com':165 'github.com/microsoftdocs/mcp/blob/main/readme.md)':164 'group':30,250,388 'guid':163 'guidanc':51 'handl':264 'helm':231,252,307,361,399,500,533,560 'ident':280,468 'imag':334,555 'implement':398 'import':84,128 'includ':14 'index':90,210 'instal':160,162,233,362 'integr':21,64,320,535,542 'interrupt':488 'issu':223,356 'knowledg':7 'l120':104 'l33':216 'l33-l38':215 'l35':103 'l35-l120':102 'l38':217 'l39':242 'l39-l47':241 'l47':243 'l48':267 'l48-l55':266 'l55':268 'l56':294 'l56-l65':293 'l65':295 'l66':324 'l66-l75':323 'l75':325 'latest':145 'learn':188,202 'learn-agent-skil':187,201 'learn.microsoft.com':358,369,384,396,406,415,425,438,449,460,472,486,497,508,519,530,540,557,568,582,595,608,619,630 'learn.microsoft.com/en-us/azure/operator-service-manager/best-practices-onboard-deploy':383 'learn.microsoft.com/en-us/azure/operator-service-manager/concepts-cli-containerized-network-function-image-upload':556 'learn.microsoft.com/en-us/azure/operator-service-manager/concepts-expose-parameters-configuration-group-schema':567 'learn.microsoft.com/en-us/azure/operator-service-manager/configuration-guide':395 'learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-cluster-registry':485 'learn.microsoft.com/en-us/azure/operator-service-manager/get-started-with-private-link':437 'learn.microsoft.com/en-us/azure/operator-service-manager/helm-requirements':405 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-assign-custom-role':448 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-cancel-service-deployments':496 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-custom-role':459 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-create-user-assigned-managed-identity':471 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-nexus':581 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-manage-artifacts-virtualized-network-function-cloud':594 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-azure-resource-manager-resources-cli':607 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-containerized-network-function-cli':618 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-onboard-virtualized-network-function-cli':629 'learn.microsoft.com/en-us/azure/operator-service-manager/how-to-use-helm-option-parameters':507 'learn.microsoft.com/en-us/azure/operator-service-manager/manage-network-function-operator':518 'learn.microsoft.com/en-us/azure/operator-service-manager/publisher-artifact-store-resiliency':529 'learn.microsoft.com/en-us/azure/operator-service-manager/resource-cleanup-management':414 'learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-helm-test':539 'learn.microsoft.com/en-us/azure/operator-service-manager/safe-upgrades-nf-level-rollback':424 'learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-cli-common-issues':357 'learn.microsoft.com/en-us/azure/operator-service-manager/troubleshoot-helm-install-failures':368 'least':284 'least-privileg':283 'line':99,111,212 'link':37,116,125,273,433 'local':69 'locat':93 'manag':5,12,45,56,279,333,394,408,467,516 'map':559 'markdown':192,208 'mcp':151,178 'metadata.generated':132 'microsoft':180 'microsoftdoc':152,179 'month':138 'network':170,344,493,602 'nexus':628 'nfo':310,512 'old':139 'onboard':26,222,248,331,355,376,610,621 'oper':3,10,43,54,290,392,458 'overrid':499 'paramet':563 'pattern':23,66,322,544 'pausing/resuming':305 'practic':17,60,240,245,372,380,402 'prefer':176 'privat':36,272,432 'privileg':285 'provid':49 'publish':410 'pull':143,572,586 'push':570,584 'queri':184,198 'quick':71 'quick-refer':70 'rang':100 'rbac':453 'rbac/roles':275 'read':106,121 'refer':72,126 'registri':301,481 'relev':94 'remot':75 'replic':317,524 'repositori':149 'requir':169 'resili':304,484 'resourc':342,599 'resum':490 'return':191,207 'role':443,454 'runtim':298 'section':95 'secur':18,61,265,269,288,427,435,445 'security.md':118,119 'servic':4,11,44,55,345,393,457,494,603 'set':309,477 'site':492 'skill':46,48,83,168,190,204 'skill-azure-operator-service-manager' 'sns':446 'sns/service':289 'source-microsoftdocs' 'specifi':110 'storag':591 'storage-back':590 'store':319,338,528,580,593 'string':185,199 'suggest':140,157 'test':534 'text/markdown':206 'tool':153 'topic':348,373,428,475,545 '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':15,58,214,230,347,350 'upgrad':260,419,538 'upload':553 'url':349,374,429,476,546 'usag':254 'use':24,31,81,87,105,120,177,194,326,464,510,547,614 'user':142,159,277,465 'version':146 'via':605 'vnfs':622 'webpag':196","prices":[{"id":"233e857d-f236-42a3-9abb-243967ed96dc","listingId":"91e43b10-b03d-4b97-b046-b55039712e88","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:59:39.869Z"}],"sources":[{"listingId":"91e43b10-b03d-4b97-b046-b55039712e88","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-operator-service-manager","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-operator-service-manager","isPrimary":false,"firstSeenAt":"2026-04-18T21:59:39.869Z","lastSeenAt":"2026-04-22T00:53:35.105Z"}],"details":{"listingId":"91e43b10-b03d-4b97-b046-b55039712e88","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-operator-service-manager","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-19T02:43:40Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"d268dca48a037b9704860e566791457fc7668f7c","skill_md_path":"skills/azure-operator-service-manager/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-operator-service-manager"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-operator-service-manager","description":"Expert knowledge for Azure Operator Service Manager development including troubleshooting, best practices, security, configuration, and integrations & coding patterns. Use when onboarding CNFs/VNFs, designing config groups, using ACR-backed artifacts, Private Link, or AOSM CLI, and other Azure Operator Service Manager related development tasks. Not for Azure Operator Insights (use azure-operator-insights), Azure Operator Nexus (use azure-operator-nexus), Azure Network Function Manager (use azure-network-function-manager), Azure Networking (use azure-networking).","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-operator-service-manager"},"updatedAt":"2026-04-22T00:53:35.105Z"}}