mcpField
A
azure-signalr-service

azure-signalr-service

github.com/microsoftdocs云与 DevOps796179 次安装3 天前更新
代码仓库

关于 azure-signalr-service

为处理 Azure SignalR Service 的 Agent 提供参考指南，涵盖配置、架构、安全、部署和故障排查，并结合本地速查内容与远程文档获取。

主要功能

  1. 01连接与消息故障排查
  2. 02服务模式和高可用设计
  3. 03容量、性能与扩展指导
  4. 04身份验证和网络安全配置
  5. 05SDK、REST API 与部署参考

适用场景

  1. 01排查连接中断或消息投递问题
  2. 02设计多区域或分片架构
  3. 03规划容量并调整实例规模
  4. 04配置身份验证、监控与上游端点

MCP 相关

可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 获取远程文档；也可用 fetch_webpage 作为替代。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-signalr-service

安装后在 Claude Code 中输入/azure-signalr-service确认已加载。

详细介绍

Azure SignalR Service 技能

此技能提供 Azure SignalR Service 专业指导，涵盖故障排除、最佳实践、决策、架构与设计模式、限制与配额、安全性、配置、集成与编码模式，以及部署。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下方的类别索引查找相关章节。对于带有行号范围的类别（例如 L35-L120），使用 read_file 读取指定行。对于带有文件链接的类别（例如 [security.md](security.md)），使用 read_file 读取链接的参考文件。

IMPORTANT for Agent：如果 metadata.generated_at 距今已超过 3 个月，请建议用户从存储库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问才能获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并在查询字符串中附加 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并在查询字符串中附加 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行描述
故障排除L37-L45诊断和修复 SignalR 问题：连接和消息传递问题、实时跟踪和 Azure Monitor 日志、常见错误模式，以及确保可靠运行的最佳实践。
最佳实践L46-L51安全关闭 SignalR 应用服务器以及管理客户端生命周期事件的指南，包括检测、处理和恢复客户端断开连接与重新连接。
决策L52-L56选择合适的 SignalR Service 模式（Default/Serverless/Classic），以及配置可用性区域/区域冗余，以实现高可用性和弹性。
架构与设计模式L57-L63SignalR 扩展和分片、设计弹性多区域拓扑，以及使用 Azure SignalR 构建高可用、高吞吐量 ASP.NET Core SignalR 应用的模式。
限制与配额L64-L70消息/连接计费规则、容量规划、吞吐量限制，以及如何在配额和性能约束范围内扩展 Azure SignalR 实例。
安全性L71-L92保护 Azure SignalR：使用 Entra ID/托管标识进行身份验证、密钥及其轮换、网络/专用终结点/NSG、WAF、Key Vault 访问、RBAC、跨租户和 Azure Policy 合规性。
配置L93-L104配置 SignalR 应用：连接字符串、上游终结点、自定义域、监视/指标、协商终结点、Functions 绑定，以及使用本地模拟器。
集成与编码模式L105-L120将 SignalR 与服务器和网关集成的模式与 API：SDK 用法、客户端管理、REST 数据平面版本，以及通过 Event Grid、API Management 和 Application Gateway 接入事件。
部署L121-L131通过 CLI、ARM/Bicep 模板部署和管理 Azure SignalR、设置自动缩放、迁移区域，以及端到端部署 Web 应用（包括 GitHub 身份验证）。
故障排除
主题URL
使用 Azure Monitor 资源日志排查 SignalR 问题https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-diagnostic-logs
排查常见的 Azure SignalR Service 问题https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-guide
使用 Azure SignalR 实时跟踪工具进行诊断https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-live-trace
排查 SignalR 连接和消息传递问题https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-method
有效排查和使用 Azure SignalR Servicehttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-resource-faq
最佳实践
主题URL
平稳关闭 Azure SignalR 应用服务器https://learn.microsoft.com/en-us/azure/azure-signalr/server-graceful-shutdown
处理 Azure SignalR 中客户端的断开连接和重新连接https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-client-disconnections
决策
主题URL
选择合适的 Azure SignalR Service 模式https://learn.microsoft.com/en-us/azure/azure-signalr/concept-service-mode
架构与设计模式
主题URL
设计具有韧性的多区域 Azure SignalR 拓扑https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-disaster-recovery
使用 Azure SignalR 扩展 ASP.NET Core SignalR 应用https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-scale-aspnet-core
使用多个实例和分片扩展 Azure SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-scale-multi-instances
限制与配额
主题URL
了解 SignalR 计费中的消息和连接计数方式https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-messages-and-connections
规划 Azure SignalR 性能和容量https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-performance
扩展 Azure SignalR 实例并了解扩展限制https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-scale-signalr
安全性
主题URL
禁用访问密钥身份验证，并为 SignalR 强制使用 Entra IDhttps://learn.microsoft.com/en-us/azure/azure-signalr/howto-disable-local-auth
配置 Azure SignalR 的网络访问控制https://learn.microsoft.com/en-us/azure/azure-signalr/howto-network-access-control
使用专用终结点保护 Azure SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/howto-private-endpoints
在 NSG 中使用 Azure SignalR 服务标记https://learn.microsoft.com/en-us/azure/azure-signalr/howto-service-tags
通过共享专用终结点保护 SignalR 出站流量https://learn.microsoft.com/en-us/azure/azure-signalr/howto-shared-private-endpoints
从 Azure SignalR 私下访问 Key Vaulthttps://learn.microsoft.com/en-us/azure/azure-signalr/howto-shared-private-endpoints-key-vault
在 Azure SignalR Service 中使用托管标识https://learn.microsoft.com/en-us/azure/azure-signalr/howto-use-managed-identity
Azure SignalR 的内置 Azure Policy 定义https://learn.microsoft.com/en-us/azure/azure-signalr/policy-reference
将 Azure Policy 法规合规性控制应用于 SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/security-controls-policy
为 Azure SignalR 客户端实现自定义身份验证https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-authenticate-oauth
使用 Microsoft Entra ID RBAC 授权访问 Azure SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-authorize-azure-active-directory
使用 Microsoft Entra 应用程序授权 Azure SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-authorize-application
配置 Azure SignalR 的跨租户授权https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-authorize-cross-tenant
使用托管标识授权 Azure SignalRhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-authorize-managed-identity
使用 Azure Policy 强制 Azure SignalR 合规https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-azure-policy
配置 Azure SignalR 应用程序防火墙规则https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-configure-application-firewall
安全轮换 Azure SignalR 访问密钥https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-key-rotation
使用 Azure Functions 绑定对 Azure SignalR 客户端进行身份验证https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-tutorial-authenticate-azure-functions
配置
主题URL
在应用中配置 Azure SignalR Service 连接字符串https://learn.microsoft.com/en-us/azure/azure-signalr/concept-connection-string
在 Azure SignalR 中配置上游终结点和协议https://learn.microsoft.com/en-us/azure/azure-signalr/concept-upstream
为 Azure SignalR Service 配置自定义域https://learn.microsoft.com/en-us/azure/azure-signalr/howto-custom-domain
使用 Azure Monitor 配置 Azure SignalR 监视https://learn.microsoft.com/en-us/azure/azure-signalr/monitor-signalr
Azure SignalR 监视指标和日志参考https://learn.microsoft.com/en-us/azure/azure-signalr/monitor-signalr-reference
自定义 Azure SignalR 中的客户端协商终结点https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-client-negotiation
使用 SignalR 绑定开发和配置 Azure Functions 应用https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-serverless-development-config
使用 Azure SignalR Local Emulator 进行无服务器开发https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-emulator
集成与编码模式
主题URL
将 Azure SignalR Service 事件与 Event Grid 集成https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-event-grid-integration
将 Azure SignalR 事件与 Event Grid 集成https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-event-grid-integration
在应用服务器中使用 Azure SignalR Service SDKhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-use
使用 Management SDK 管理 Azure SignalR 客户端https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-use-management-sdk
将 Azure SignalR 与 API Management 配合使用https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-work-with-apim
将 Azure SignalR 与 Application Gateway 配合使用https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-work-with-app-gateway
使用 Azure SignalR REST API 进行服务器到客户端的消息传递https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-quickstart-rest-api
使用 Azure SignalR 数据平面 REST APIhttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-reference-data-plane-rest-api
与 Azure SignalR REST API v1 集成https://learn.microsoft.com/en-us/azure/azure-signalr/swagger/signalr-data-plane-rest-v1
与 Azure SignalR REST API v1-preview 集成https://learn.microsoft.com/en-us/azure/azure-signalr/swagger/signalr-data-plane-rest-v1-preview
与 Azure SignalR REST API v20220601 集成https://learn.microsoft.com/en-us/azure/azure-signalr/swagger/signalr-data-plane-rest-v20220601
与 Azure SignalR REST API v20241201 集成https://learn.microsoft.com/en-us/azure/azure-signalr/swagger/signalr-data-plane-rest-v20241201
部署
主题URL
通过 Azure CLI 脚本创建 Azure SignalR Servicehttps://learn.microsoft.com/en-us/azure/azure-signalr/scripts/signalr-cli-create-service
使用 Azure CLI 通过 App Service 预配 SignalR Servicehttps://learn.microsoft.com/en-us/azure/azure-signalr/scripts/signalr-cli-create-with-app-service
通过 CLI 部署使用 GitHub 身份验证的 SignalR Web 应用https://learn.microsoft.com/en-us/azure/azure-signalr/scripts/signalr-cli-create-with-app-service-github-oauth
使用 ARM 模板跨区域迁移 Azure SignalR 资源https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-move-across-regions
为 Azure SignalR Premium 层配置自动缩放https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-scale-autoscale
使用 ARM 模板部署 Azure SignalR Servicehttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-quickstart-azure-signalr-service-arm-template
使用 Bicep 模板部署 Azure SignalR Servicehttps://learn.microsoft.com/en-us/azure/azure-signalr/signalr-quickstart-azure-signalr-service-bicep
用于部署 SignalR Service 的 Azure CLI 脚本示例https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-reference-cli

评论

支持 Markdown