mcpField
A
azure-service-bus

azure-service-bus

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

关于 azure-service-bus

面向 Azure Service Bus 用户和 Agent 的指导技能，将本地参考资料与网络文档结合，涵盖消息运维、架构、安全和部署。

主要功能

  1. 01消息问题排查
  2. 02消息处理最佳实践
  3. 03架构与决策指导
  4. 04限制、配额与安全
  5. 05配置与部署

适用场景

  1. 01诊断 AMQP 或 SDK 错误
  2. 02设计可靠的消息系统
  3. 03选择层级或 SDK
  4. 04配置队列和订阅

MCP 相关

该技能可通过 mcp_microsoftdocs:microsoft_docs_fetch 工具获取文档，也可使用网页抓取作为后备方案。

安装

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

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

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

详细介绍

Azure Service Bus 技能

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

如何使用此技能

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-L46诊断和修复 Service Bus 问题：AMQP 错误、SDK/Resource Manager 异常、旧版错误代码，以及用于调试的端到端操作跟踪。
最佳实践L47-L61设计可靠、高性能的 Service Bus 消息传递：消息设计、筛选器、锁定/结算、重复检测、预提取、超时/重试、指标和维护，以避免消息丢失/重复。
决策制定L62-L71选择 Service Bus 与其他消息传递选项、选择层级和 SDK，以及为工作负载规划异地灾难恢复和迁移（Standard→Premium）的指导。
架构与设计模式L72-L82构建具有复原能力、异地复制的多命名空间 Service Bus 架构的模式，包括分区、自动转发链、联合，以及使用 NServiceBus 进行消息复制。
限制与配额L83-L90Azure Service Bus 的配额、指标和限制流量行为：消息/实体限制、吞吐量上限、指标与限制的对应关系，以及达到限制时会发生什么的常见问题解答。
安全性L91-L115配置 Service Bus 安全性：Entra ID 身份验证、托管标识、SAS、加密/CMK、网络隔离（VNet、Private Link、防火墙）、TLS 策略，以及合规性/Azure Policy。
配置L116-L141配置和管理 Service Bus 实体：扩展、会话、分区、转发、TTL/死信、筛选器/操作、AMQP/HTTP 设置、监视、自动化和本地模拟。
集成与编码模式L142-L154将 Service Bus 与 JMS（1.1/2.0）、ActiveMQ、RabbitMQ、Event Grid、Logic Apps、Functions 集成的模式和代码，以及批量删除消息和通过 AMQP 实现互操作。
部署L155-L164使用 ARM/Bicep 模板部署 Service Bus 命名空间和实体（队列、主题、订阅、规则），以及在 Azure 区域之间移动命名空间。
故障排除
主题URL
排查 Azure Service Bus 中的 AMQP 错误https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-troubleshoot
跟踪并诊断 Azure Service Bus 端到端操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing
解读旧版 Azure Service Bus 消息传送错误https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions
处理 Azure Service Bus 消息传送异常（当前 SDK）https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions-latest
诊断 Azure Service Bus Resource Manager 异常https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-exceptions
诊断并修复常见的 Azure Service Bus 问题https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-troubleshooting-guide
最佳实践
主题URL
配置 Service Bus 重复消息检测https://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection
获取并使用 Service Bus 消息计数指标https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
在 Service Bus 消息中使用序列号和时间戳https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing
处理 Service Bus 中的消息锁定和结算https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-transfers-locks-settlement
为计划内维护准备 Service Bus 命名空间https://learn.microsoft.com/en-us/azure/service-bus-messaging/prepare-for-planned-maintenance
定义并应用 Service Bus 订阅筛选器https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
防止 Azure Service Bus 消息丢失和重复https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-message-loss-and-duplicates
设计 Azure Service Bus 消息和负载https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
应用 Azure Service Bus 性能最佳实践https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
优化 Azure Service Bus 预提取行为https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch
配置 Service Bus 超时和重试策略https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-timeouts-retries
决策
主题URL
在 Azure Event Grid、Event Hubs 和 Service Bus 之间进行选择https://learn.microsoft.com/en-us/azure/service-bus-messaging/compare-messaging-services
在 Azure Storage 队列和 Service Bus 队列之间进行选择https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-azure-and-service-bus-queues-compared-contrasted
设置 Service Bus 地理灾难恢复https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-dr
在 JMS 和 Azure Service Bus 原生 Java SDK 之间进行选择https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-jms-versus-native-sdk
将 Azure Service Bus 从 Standard 迁移到 Premiumhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-standard-premium
为工作负载选择 Azure Service Bus Premium 层https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-premium-messaging
架构与设计模式
主题URL
使用 NServiceBus 在 Service Bus 上构建消息驱动系统https://learn.microsoft.com/en-us/azure/service-bus-messaging/build-message-driven-apps-nservicebus
使用自动转发设计链式 Azure Service Bus 实体https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding
设计 Service Bus 联邦和复制拓扑https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-overview
实现 Service Bus 消息复制模式https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-patterns
为 Azure Service Bus 命名空间设计异地复制https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication
设计多命名空间 Service Bus 以增强弹性https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-outages-disasters
设计并创建分区 Service Bus 队列和主题https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-partitioning
限制与配额
主题URL
将 Azure Service Bus 指标对应到配额和限制https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
Azure Service Bus 常见问题：限制和行为https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-faq
查看 Azure Service Bus 配额和限制流量阈值https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quotas
了解 Azure Service Bus 限制流量阈值和行为https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-throttling
安全
主题URL
为 Service Bus 配置 Microsoft Entra 身份验证https://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application
为 Service Bus Premium 启用机密计算https://learn.microsoft.com/en-us/azure/service-bus-messaging/confidential-computing
为 Service Bus 加密配置客户管理的密钥https://learn.microsoft.com/en-us/azure/service-bus-messaging/configure-customer-managed-key
禁用 Azure Service Bus 的 SAS 本地身份验证https://learn.microsoft.com/en-us/azure/service-bus-messaging/disable-local-authentication
为 Azure Service Bus 命名空间配置网络安全https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
为 Azure Service Bus 配置网络安全外围https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
使用内置 Azure Policy 定义配置 Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
使用 Private Link Service 保护 Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
对 Azure Service Bus 应用安全最佳做法https://learn.microsoft.com/en-us/azure/service-bus-messaging/secure-service-bus
对 Service Bus 应用法规合规策略https://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
为 Azure Service Bus 配置身份验证和授权https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-authentication-and-authorization
为 Azure Service Bus 配置 IP 防火墙规则https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-ip-filtering
使用托管标识安全访问 Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-managed-service-identity
将 Service Bus 应用迁移到无密码 Entra ID 身份验证https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-azure-credentials
使用 ARM 模板创建 Service Bus 授权规则https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-auth-rule
通过 REST 使用 Entra ID 令牌发送 Service Bus 消息https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-send-entra-token-how-to
为 Azure Service Bus 实现共享访问签名授权https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas
配置 Service Bus 虚拟网络服务终结点https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-service-endpoints
使用 Azure Policy 审核 Service Bus TLS 最低版本合规性https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-audit-minimum-version
为 Service Bus 命名空间配置最低 TLS 版本https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-configure-minimum-version
为 Azure Service Bus 强制实施最低 TLS 版本https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version
配置
主题URL
为 Service Bus 消息传送单元配置自动缩放https://learn.microsoft.com/en-us/azure/service-bus-messaging/automate-update-messaging-units
将经典 Service Bus 管理 API 映射到 ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
配置 Service Bus 实体之间的自动转发https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
为 Service Bus 实体启用死信队列https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
为 Service Bus 实体配置重复检测https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection
启用并配置 Service Bus 消息会话https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions
为 Service Bus 队列和主题启用分区https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
暂停并重新激活 Azure Service Bus 实体https://learn.microsoft.com/en-us/azure/service-bus-messaging/entity-suspend
使用 peek 操作浏览 Service Bus 消息https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
在 Azure Service Bus 中配置消息过期时间和 TTLhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-expiration
使用 Azure Monitor 配置 Azure Service Bus 监视https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
迁移 .NET Service Bus 时配置 AMQP 设置https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
在 Service Bus 中使用 AMQP 请求/响应操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
配置基于 Azure Functions 的 Service Bus 复制任务https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-configuration
使用 Azure Monitor Insights 监视 Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-insights
使用 Azure PowerShell 管理 Service Bus 资源https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-manage-with-ps
以编程方式创建和管理 Service Bus 命名空间及实体https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
为 Service Bus 订阅配置 SQL 筛选器表达式https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-filter
为 Service Bus 订阅规则使用 SQL 操作语法https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-rule-action
将 HTTP 标头映射到 Service Bus 消息属性https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-message-properties
配置 Service Bus 的 REST 命名空间寻址https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-namespace-access
配置并运行 Azure Service Bus 本地模拟器https://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator
集成与编码模式
主题URL
以批次方式以编程方式删除 Service Bus 消息https://learn.microsoft.com/en-us/azure/service-bus-messaging/batch-delete
将 JMS 2.0 API 与 Azure Service Bus 配合使用https://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
使用 JMS 2.0 开发 Azure Service Bus 客户端https://learn.microsoft.com/en-us/azure/service-bus-messaging/jms-developer-guide
将 JMS 应用从 ActiveMQ 迁移到 Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/migrate-jms-activemq-to-servicebus
将 RabbitMQ 与 Azure Service Bus 集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
在 Service Bus Standard 上通过 AMQP 集成 JMS 1.1https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-java-how-to-use-jms-api-amqp
将 Azure Service Bus 与 Event Grid 集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-concept
使用 Event Grid 和 Logic Apps 集成 Service Bus 事件https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-example
通过 Event Grid 和 Azure Functions 处理 Service Bus 事件https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-function
部署
主题URL
在不同区域之间迁移 Azure Service Bus 命名空间https://learn.microsoft.com/en-us/azure/service-bus-messaging/move-across-regions
使用 ARM 模板创建 Service Bus 命名空间https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace
使用 ARM 模板部署 Service Bus 命名空间和队列https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue
使用 Bicep 部署 Service Bus 命名空间和队列https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue-bicep
通过 ARM 部署 Service Bus 命名空间、主题和订阅https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic
通过 ARM 部署 Service Bus 主题、订阅和规则https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic-with-rule
使用 ARM 模板部署 Service Bus 资源https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-overview

评论

支持 Markdown