About azure-operator-nexus
azure-operator-nexus is a guidance skill for teams operating Azure Operator Nexus. It combines a local topic index with remote documentation retrieval for troubleshooting, design, security, configuration, and deployment.
Key features
- 01Troubleshooting Nexus infrastructure
- 02Architecture and placement guidance
- 03Security and configuration references
- 04Limits, quotas, and deployment guidance
- 05Local index with remote documentation retrieval
Use cases
- 01Diagnosing bare-metal, storage, or networking issues
- 02Planning resilient Nexus cluster architecture
- 03Reviewing security and access configuration
MCP support
The skill can retrieve documentation through the mcp_microsoftdocs Microsoft Docs fetch tool; fetch_webpage is listed as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-operator-nexusAfter installing, type/azure-operator-nexusin Claude Code to confirm it loaded.
Details
From the project READMEAzure Operator Nexus Skill
This skill provides expert guidance for Azure Operator Nexus. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, 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: If
metadata.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 | L36-L83 | Diagnosing and fixing Nexus bare-metal, storage, networking, Kubernetes, and upgrade issues, including provisioning failures, pod/volume errors, connectivity, and hardware validation problems. |
| Best Practices | L84-L88 | Guidance on Nexus bare metal lifecycle ops, ETCD maintenance in Nexus AKS, and procedures for repairing and maintaining Nexus storage appliance components. |
| Decision Making | L89-L95 | Guidance for planning Nexus cluster placement, choosing Nexus and Kubernetes VM SKUs/versions, and mapping Nexus releases to supported storage software. |
| Architecture & Design Patterns | L96-L100 | Design patterns and reference architectures for resilient Nexus deployments, including rack-failure-tolerant control planes and near-edge storage topology and capacity planning. |
| Limits & Quotas | L101-L113 | Limits, capacity planning, and quotas for Nexus storage and isolation domains, supported software/runtime versions, upgrade cadence, and troubleshooting issues like node restarts or log disruption. |
| Security | L114-L152 | Securing Nexus: identity/RBAC, managed identities, ACLs, SSH/serial access, break-glass methods, credential/Key Vault rotation, Defender/Policy, and secure VM/cluster connectivity. |
| Configuration | L153-L225 | Configuring and operating Azure Operator Nexus: cluster templates/parameters, fabric ACLs and route policies, BGP/VRF limits, isolation domains, Kubernetes settings, monitoring, security, and upgrade workflows. |
| Deployment | L226-L233 | Deploying and maintaining Nexus platform and fabric: prerequisites, image building, OS and fabric upgrades, and replacing or updating terminal servers in the network fabric. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Best practices for bare metal machine lifecycle operations in Operator Nexus | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-bare-metal-best-practices |
Decision Making
| Topic | URL |
|---|---|
| Plan resource placement for Nexus Kubernetes clusters | https://learn.microsoft.com/en-us/azure/operator-nexus/concepts-nexus-kubernetes-placement |
| Select Azure Operator Nexus Kubernetes VM SKUs | https://learn.microsoft.com/en-us/azure/operator-nexus/reference-nexus-kubernetes-cluster-sku |
| Select and manage supported Kubernetes versions in Operator Nexus | https://learn.microsoft.com/en-us/azure/operator-nexus/reference-nexus-kubernetes-cluster-supported-versions |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design rack-resilient control plane for Operator Nexus | https://learn.microsoft.com/en-us/azure/operator-nexus/concepts-rack-resiliency |
Limits & Quotas
Security
Configuration
Deployment
| Topic | URL |
|---|---|
| Prepare Azure Operator Nexus platform deployment prerequisites | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-platform-prerequisites |
| Replace a terminal server in Azure Operator Nexus Network Fabric | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-replace-terminal-server |
| Pre-validate and upgrade Azure Operator Nexus fabric | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-upgrade-nexus-fabric |
| Use template to upgrade Azure Operator Nexus fabric | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-upgrade-nexus-fabric-template |
| Build VM images for Azure Operator Nexus | https://learn.microsoft.com/en-us/azure/operator-nexus/howto-virtual-machine-image |