azure-web-pubsub
Azure Web PubSubを用いたWebSocket/Socket.IO/MQTTアプリ開発において、トラブルシューティング、ベストプラクティス、セキュリティ、構成、デプロイなど、専門的な知識と実践的なガイダンスを提供するSkill。
📜 元の英語説明(参考)
Expert knowledge for Azure Web PubSub development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building WebSocket/Socket.IO/MQTT apps, configuring geo-replication, custom domains, metrics/alerts, or Functions bindings, and other Azure Web PubSub related development tasks. Not for Azure SignalR Service (use azure-signalr-service), Azure Event Hubs (use azure-event-hubs), Azure Service Bus (use azure-service-bus), Azure Relay (use azure-relay).
🇯🇵 日本人クリエイター向け解説
Azure Web PubSubを用いたWebSocket/Socket.IO/MQTTアプリ開発において、トラブルシューティング、ベストプラクティス、セキュリティ、構成、デプロイなど、専門的な知識と実践的なガイダンスを提供するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-web-pubsub.zip https://jpskill.com/download/5804.zip && unzip -o azure-web-pubsub.zip && rm azure-web-pubsub.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5804.zip -OutFile "$d\azure-web-pubsub.zip"; Expand-Archive "$d\azure-web-pubsub.zip" -DestinationPath $d -Force; ri "$d\azure-web-pubsub.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
azure-web-pubsub.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
azure-web-pubsubフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure Web PubSub スキル
このスキルは、Azure Web PubSub に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイメントを網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使い方
Agent への重要事項: 関連セクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲のあるカテゴリ(例:
L35-L120)の場合は、指定された行でread_fileを使用してください。ファイルリンクのあるカテゴリ(例:[security.md](security.md))の場合は、リンクされた参照ファイルでread_fileを使用してください。
Agent への重要事項:
metadata.generated_atが 3 か月以上前の場合は、ユーザーにリポジトリから最新バージョンをプルするように提案してください。mcp_microsoftdocsツールが利用できない場合は、ユーザーにインストールを提案してください: インストールガイド
このスキルは、ドキュメントコンテンツを取得するためにネットワークアクセスを必要とします。
- 推奨: クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用してください。Markdown を返します。 - フォールバック: クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用してください。Markdown を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L46 | Azure Web PubSub の問題の診断と修正: ローカルハンドラーのデバッグ、サービス/リソースログ、一般的なエラー、Socket.IO 固有のトラブルシューティングと診断。 |
| ベストプラクティス | L47-L51 | Azure Web PubSub 用の回復性のある WebSocket クライアントを構築するためのガイダンス。再接続戦略、切断の処理、エラー処理、接続ライフサイクルのベストプラクティスを含みます。 |
| 意思決定 | L52-L56 | ゾーンを使用した高可用性 Web PubSub の構成、および価格、課金メーター、コストに関する考慮事項の理解に関するガイダンス。 |
| アーキテクチャと設計パターン | L57-L63 | Web PubSub のアーキテクチャパターン: マルチリージョン回復性、MQTT と Web PubSub のブリッジング、Socket.IO プロトコルサポートのための内部設計の詳細。 |
| 制限とクォータ | L64-L69 | Web PubSub の容量とパフォーマンスの制限(接続、メッセージ、スケーリング)、およびサポートされていない、または動作が異なる Socket.IO サーバー API。 |
| セキュリティ | L70-L99 | Azure Web PubSub のセキュリティ保護: Entra ID/マネージド ID/キーによる認証、mTLS、ネットワーク分離(VNet、プライベートエンドポイント、ファイアウォール)、ポリシー、キーローテーション、WebSocket/Socket.IO/MQTT のクライアント認証。 |
| 構成 | L100-L115 | Web PubSub の動作の構成: 監視/メトリック、アラート、カスタムドメイン、イベントルーティング、地理的レプリケーション、クライアント URL、Socket.IO/MQTT オプション、ローカルトンネリング、OData フィルター。 |
| 統合とコーディングパターン | L116-L145 | Azure Web PubSub のクライアント/サーバー統合パターン: SDK の使用、WebSocket/MQTT、REST、CloudEvents、Functions バインディング、Socket.IO、認証、信頼性の高いメッセージングサブプロトコル。 |
| デプロイメント | L146-L152 | Web PubSub をリージョン間で移動するガイド、Premium 自動スケーリングの構成、および Socket.IO アプリとサーバーレスチャットを Azure Web PubSub にデプロイ/移行するガイド。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Web PubSub イベントハンドラーをローカルでデバッグする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-local-debug-event-handler |
| 一般的な Azure Web PubSub の問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-common-issues |
| Web PubSub リソースログを使用してトラブルシューティングする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-resource-logs |
| 一般的な Azure Web PubSub サービスの問題を解決する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/resource-faq |
| Socket.IO の Web PubSub の一般的な問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-common-issues |
| Web PubSub Socket.IO の診断ログを収集する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-logging |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Web PubSub 用の信頼性の高い WebSocket クライアントを設計する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-develop-reliable-clients |
意思決定
| トピック | URL |
|---|---|
| Azure Web PubSub の課金モデルを理解する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-billing-model |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| 回復性のあるマルチリージョン Azure Web PubSub を設計する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-disaster-recovery |
| MQTT と Web PubSub 間のクロスプロトコル通信 | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-mqtt-cross-protocol-communication |
| Socket.IO サポートのための Web PubSub の内部設計 | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-service-internal |
制限とクォータ
| トピック | URL |
|---|---|
| Web PubSub のパフォーマンスと容量を計画する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-performance |
| Web PubSub でサポートされていない Socket.IO サーバー API | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-supported-server-apis |
セキュリティ
| トピック | URL |
|---|---|
| Microsoft Entra ID で Web PubSub アクセスを承認する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-azure-ad-authorization |
| Azure Web PubSub でワイルドカードグループロールのアクセス許可を構成する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-wildcard-group-roles |
| Microsoft Entra アプリケーションで Azure Web PubSub リクエストを承認する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-authorize-from-application |
| マネージド ID で Azure Web PubSub を承認する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-authorize-from-managed-identity |
| クライアント証明書 (mTL |
(原文がここで切り詰められています)
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure Web PubSub Skill
This skill provides expert guidance for Azure Web PubSub. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, 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 | L37-L46 | Diagnosing and fixing Azure Web PubSub issues: local handler debugging, service/resource logs, common errors, and Socket.IO-specific troubleshooting and diagnostics. |
| Best Practices | L47-L51 | Guidance on building resilient WebSocket clients for Azure Web PubSub, including reconnection strategies, handling disconnects, error handling, and connection lifecycle best practices. |
| Decision Making | L52-L56 | Guidance on configuring Web PubSub for high availability with zones and understanding pricing, billing meters, and cost considerations |
| Architecture & Design Patterns | L57-L63 | Architectural patterns for Web PubSub: multi-region resiliency, bridging MQTT with Web PubSub, and internal design details for Socket.IO protocol support. |
| Limits & Quotas | L64-L69 | Capacity and performance limits for Web PubSub (connections, messages, scaling) and which Socket.IO server APIs aren’t supported or behave differently. |
| Security | L70-L99 | Securing Azure Web PubSub: auth with Entra ID/managed identity/keys, mTLS, network isolation (VNets, private endpoints, firewalls), policies, key rotation, and client auth for WebSocket/Socket.IO/MQTT. |
| Configuration | L100-L115 | Configuring Web PubSub behavior: monitoring/metrics, alerts, custom domains, event routing, geo-replication, client URLs, Socket.IO/MQTT options, local tunneling, and OData filters. |
| Integrations & Coding Patterns | L116-L145 | Client/server integration patterns for Azure Web PubSub: SDK usage, WebSocket/MQTT, REST, CloudEvents, Functions bindings, Socket.IO, auth, and reliable messaging subprotocols. |
| Deployment | L146-L152 | Guides for moving Web PubSub across regions, configuring Premium autoscale, and deploying/migrating Socket.IO apps and serverless chat to Azure Web PubSub. |
Troubleshooting
| Topic | URL |
|---|---|
| Debug Azure Web PubSub event handlers locally | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-local-debug-event-handler |
| Troubleshoot common Azure Web PubSub issues | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-common-issues |
| Use Web PubSub resource logs for troubleshooting | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-resource-logs |
| Resolve common Azure Web PubSub service issues | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/resource-faq |
| Troubleshoot Web PubSub for Socket.IO common issues | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-common-issues |
| Collect diagnostic logs for Web PubSub Socket.IO | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-logging |
Best Practices
| Topic | URL |
|---|---|
| Design reliable WebSocket clients for Azure Web PubSub | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-develop-reliable-clients |
Decision Making
| Topic | URL |
|---|---|
| Understand Azure Web PubSub billing model | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-billing-model |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design resilient multi-region Azure Web PubSub | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-disaster-recovery |
| Cross-protocol communication between MQTT and Web PubSub | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-mqtt-cross-protocol-communication |
| Internal design of Web PubSub for Socket.IO support | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-service-internal |
Limits & Quotas
| Topic | URL |
|---|---|
| Plan Web PubSub performance and capacity | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-performance |
| Unsupported Socket.IO server APIs in Web PubSub | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-supported-server-apis |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Move Azure Web PubSub resources across regions | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-move-across-regions |
| Configure autoscale for Azure Web PubSub Premium | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-scale-autoscale |
| Deploy Socket.IO Serverless chat with Azure Functions | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socket-io-serverless-quickstart |
| Migrate self-hosted Socket.IO apps to Web PubSub | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-migrate-from-self-hosted |