Communitygithub.com

microsoft/azure-local-multi-rack

规划、部署、运营和排查 Azure Local 多机架(机架级)部署问题——预集成机架可扩展至数百台机器,基于网络结构控制器、集群管理器、SAN 存储和托管网络结构构建。适用于 Microsoft.NetworkCloud 和 Microsoft.ManagedNetworkFabric 控制平面。不适用于标准的 1-16 节点 Azure Local,也不适用于机架感知集群(两个机架作为可用区,最多 8 个节点,同步复制)——这些属于标准规模。适用场景:多机架、机架级 Azure Local、聚合机架、计算机架、网络结构控制器、NFC、集群管理器、网络结构、隔离域、az networkcloud、az networkfabric、多机架逻辑网络、多机架 Arc VM。

azure-local-multi-rack 是什么?

此技能为 AI 代理(如 Claude Code、Cursor 或 Codex)提供 Azure Local 多机架部署的完整指南。它专为管理带有预集成机架、SAN 存储和基于 Network Fabric Controller 及 Cluster Manager 的托管网络结构的大型机架级环境(超过 100 台机器)而设计。该技能通过 `mcp_azure_mcp_extension_cli_generate`、`mcp_azure_mcp_monitor`、`mcp_azure_mcp_resourcehealth` 和 `mcp_azure_mcp_documentation` 等 MCP 工具,利用 Azure CLI 扩展(`az networkcloud`、`az networkfabric`、`az stack-hci-vm`)和通用 Azure MCP 工具。它提供了结构化工作流,涵盖规划与部署、工作负载管理(VMs、AKS)、网络(隔离域、负载均衡器、NSG)以及运营与监控。关键约束包括:确认部署确实为多机架而非标准 Azure Local,在尝试任何更改前以只读模式启动,并严格遵循安全规则以避免影响聚合机架或 SAN。错误处理指南涵盖了规模混淆、缺失 CLI 扩展和风险操作等常见问题。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/microsoft/agent-skills/tree/main/.github/plugins/azure-local-skills/skills/azure-local-multi-rack

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Azure Local 多机架

多机架功能目前处于预览阶段 — 请务必声明这一点,并在做出设计承诺前从文档中确认其可用性。

快速参考

属性值
最佳适用场景机架级 Azure Local:超过 100 台机器、预集成机架、SAN、托管网络结构
规模最少四个机架 — 一个聚合机架加上三个或更多计算机架
提供程序Microsoft.NetworkCloud、Microsoft.ManagedNetworkFabric、Microsoft.AzureStackHCI
CLIaz networkcloud、az networkfabric、az stack-hci-vm
相关技能标准 1-16 节点和机架感知部署请参见 azure-local

何时使用此技能

在部署为多机架/机架级时使用:预集成机架、聚合机架、网络结构控制器、集群管理器、SAN 存储或 networkcloud/managednetworkfabric CLI 扩展。

不要用于标准 Azure Local(1-16 节点超融合,最多 64 个非聚合节点)或机架感知集群——请移交给 azure-local 技能。如果规模不明确,请先询问:即使对于听起来相同的任务(逻辑网络、VM 创建、NSG),两者的流程也是分开且不可互换的。

MCP 工具

没有专用的 MCP 命名空间。请使用通用 Azure MCP 工具:mcp_azure_mcp_extension_cli_generate(先确认 networkcloud/networkfabric 扩展)、mcp_azure_mcp_monitor(需要 Log Analytics)、mcp_azure_mcp_resourcehealth(部分支持;不包括网络结构或 SAN 运行状况)、mcp_azure_mcp_documentation(仅限多机架文章——标准 Azure Local 页面不适用)。

详情请参阅:cli-and-prereqs

工作流

  1. 确认这是多机架部署,而非标准 Azure Local——请参见“何时使用”。
  2. 规划与部署 -> plan-and-deploy
  3. VMs、AKS、映像、磁盘 -> workload-management
  4. 网络结构、隔离域、负载均衡器、NSG -> networking
  5. 监控、指标、串行控制台、故障 -> operate-and-monitor

首先阅读匹配的工作流,并使用 docs-map。以只读模式启动。在进行网络结构更改、隔离域编辑、VM 电源/删除操作或任何涉及聚合机架或 SAN 的操作之前,请先询问。

错误处理

场景补救措施
规模未知在推荐流程前询问部署是多机架还是标准。
检测到标准 Azure Local移交给 azure-local 技能;多机架流程不适用。
缺少 CLI 扩展在运行命令前按照 cli-and-prereqs 安装。
风险较高的网络结构或 SAN 更改停止并遵循 safety-rules。
文档 URL 返回 404 或重定向在 Learn 上按标题搜索,范围限定为 Azure Local 的多机架部署。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

microsoft/azure-ai-agents-persistent-dotnet

Azure AI Agents Persistent SDK for .NET. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools. Use for agent CRUD, conversation threads, streaming responses, function calling, file search, and code interpreter. Triggers: "PersistentAgentsClient", "persistent agents", "agent threads", "agent runs", "streaming agents", "function calling agents .NET".

microsoft/azure-ai-document-intelligence-dotnet

Azure AI Document Intelligence SDK for .NET. Extract text, tables, and structured data from documents using prebuilt and custom models. Use for invoice processing, receipt extraction, ID document analysis, and custom document models. Triggers: "Document Intelligence", "DocumentIntelligenceClient", "form recognizer", "invoice extraction", "receipt OCR", "document analysis .NET".

microsoft/azure-ai-openai-dotnet

Azure OpenAI SDK for .NET. Client library for Azure OpenAI and OpenAI services. Use for chat completions, embeddings, image generation, audio transcription, and assistants. Triggers: "Azure OpenAI", "AzureOpenAIClient", "ChatClient", "chat completions .NET", "GPT-4", "embeddings", "DALL-E", "Whisper", "OpenAI .NET".

microsoft/azure-ai-projects-dotnet

Azure AI Projects SDK for .NET. High-level client for Azure AI Foundry projects including agents, connections, datasets, deployments, evaluations, and indexes. Use for AI Foundry project management, versioned agents, and orchestration. Triggers: "AI Projects", "AIProjectClient", "Foundry project", "versioned agents", "evaluations", "datasets", "connections", "deployments .NET".

microsoft/azure-ai-voicelive-dotnet

Azure AI Voice Live SDK for .NET. Build real-time voice AI applications with bidirectional WebSocket communication. Use for voice assistants, conversational AI, real-time speech-to-speech, and voice-enabled chatbots. Triggers: "voice live", "real-time voice", "VoiceLiveClient", "VoiceLiveSession", "voice assistant .NET", "bidirectional audio", "speech-to-speech".

microsoft/azure-eventgrid-dotnet

Azure Event Grid SDK for .NET. Client library for publishing and consuming events with Azure Event Grid. Use for event-driven architectures, pub/sub messaging, CloudEvents, and EventGridEvents. Triggers: "Event Grid", "EventGridPublisherClient", "CloudEvent", "EventGridEvent", "publish events .NET", "event-driven", "pub/sub".

microsoft/azure-eventhub-dotnet

Azure Event Hubs SDK for .NET. Use for high-throughput event streaming: sending events (EventHubProducerClient, EventHubBufferedProducerClient), receiving events (EventProcessorClient with checkpointing), partition management, and real-time data ingestion. Triggers: "Event Hubs", "event streaming", "EventHubProducerClient", "EventProcessorClient", "send events", "receive events", "checkpointing", "partition".

microsoft/azure-identity-dotnet

Azure Identity library for .NET. Authentication library for Azure SDK clients using Microsoft Entra ID. Use for DefaultAzureCredential, managed identity, service principals, and developer credentials. Triggers: "Azure Identity", "DefaultAzureCredential", "ManagedIdentityCredential", "ClientSecretCredential", "authentication .NET", "Azure auth", "credential chain".

microsoft/azure-kusto-graph

Build and query Kusto graphs from natural language. Covers transient graphs (make-graph), persistent graph models/snapshots, pattern matching (graph-match), shortest paths, connected components, and graph-to-table export. Generates the edges-first thinking: define edges, define node lookups, union, make-graph. WHEN: make-graph, graph-match, graph-shortest-paths, graph-to-table, graph-mark-components, persistent graph, graph model, graph snapshot, build a graph from data, find paths between nodes, pattern matching in graph, connected components, transient graph, Kusto graph, KQL graph.

microsoft/azure-kusto-irql

Compose IRQL (Incident Response Query Language) queries for Kusto cybersecurity investigations. Translates natural language hunting questions into composable IRQL pipelines using Get_*, Extract_*, and Enrich_* functions. WHEN: IRQL query, security hunt, threat hunting KQL, incident response query, compose hunting pipeline, failed logins, phishing investigation, lateral movement, process execution, file creation events.

microsoft/azure-kusto-irql-graph

Apply IRQL graph functions to KQL or IRQL query results for Kusto Explorer visualization. Generates Lift_To_Graph mappings and composes Graph_Render_View, Graph_Fold_By_Property, Extract_Node_*, Enrich_Node_*, and Enrich_Graph_* calls. Accepts a supplied query or limited basic natural-language source request; it is not a general natural-language-to-KQL/IRQL skill. WHEN: Lift_To_Graph, Graph_Render_View, Graph_Fold_By_Property, IRQL graph enrichment, graph mapping for existing query results, icon-decorated graph, fold graph nodes. Use azure-kusto-graph for native make-graph analysis, graph-match, shortest paths, components, or persistent graphs.

microsoft/azure-local

Plan, deploy, operate, and troubleshoot Azure Local (formerly Azure Stack HCI): sizing and prerequisites, Arc registration, lifecycle updates, workloads (Azure Local VMs, AKS on Azure Local, images, disks, logical networks), SDN and network security, and failure triage — starting read-only and confirming before risky changes. WHEN: Azure Local, Azure Stack HCI, Arc resource bridge, custom location, Azure Local VM, Arc VM, AKS on Azure Local, AKS hybrid, SDN, Lifecycle Manager, Azure Local update, disconnected site.

相关技能