mcpField
A
azure-static-web-apps

azure-static-web-apps

github.com/microsoftdocsクラウド・DevOps801201 回インストール5 日前に更新
リポジトリ

azure-static-web-apps について

azure-static-web-appsは、Azure Static Web Appsを扱うエージェント向けスキルです。トラブルシューティング、設定、セキュリティ、統合、デプロイを扱い、ローカルの参照情報とリモート文書の取得を組み合わせます。

主な機能

  1. 01デプロイと実行時の問題調査
  2. 02プランとアーキテクチャ選定のガイダンス
  3. 03認証とアクセス制御の設定
  4. 04バックエンド、データベース、ドメインの設定
  5. 05CI/CDとプレビュー環境のデプロイ

活用シーン

  1. 01ビルドや実行時の障害の診断
  2. 02Functionsのホスティング方式とプランの選定
  3. 03アプリのAPIとAzureデータベースの接続
  4. 04レビュー用プレビュー環境の設定

MCP 対応

mcp_microsoftdocs の microsoft_docs_fetch ツールで Microsoft のドキュメントを取得できます。代替手段として fetch_webpage も記載されています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-static-web-apps

インストール後、Claude Code で/azure-static-web-appsを入力して読み込まれたか確認します。

詳細

Azure Static Web Apps スキル

このスキルでは、Azure Static Web Apps に関する専門的なガイダンスを提供します。トラブルシューティング、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。

このスキルの使い方

エージェントへの重要事項：関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行範囲が記載されているカテゴリ（例：L35-L120）では、指定された行を read_file で読み取ってください。ファイルへのリンクが記載されているカテゴリ（例：[security.md](security.md)）では、リンク先のリファレンスファイルを read_file で読み取ってください。

エージェントへの重要事項：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 が返されます。

カテゴリインデックス

カテゴリ行説明
トラブルシューティングL35-L39ビルドの失敗、構成の問題、トラブルシューティングツールやログなど、Static Web Apps の一般的なデプロイ時および実行時の問題を診断して解決します。
意思決定L40-L47Functions のホスティングモデル、Front Door／CDN エッジの利用、Next.js のデプロイオプション、Free と Standard の Static Web Apps プランの比較など、主要なアーキテクチャ上の選択に関するガイダンスです。
制限とクォータL48-L54Azure Static Web Apps の各プランのクォータ、リソースとファイルのサイズ制限、サポートされる言語とランタイム、動作上の制約について詳しく説明します。
セキュリティL55-L66認証、ロール、ユーザー情報の構成、Entra ID、カスタム認証、パスワード、プライベートエンドポイント、Key Vault を使用したアプリの保護、Static Web Apps のデプロイトークンの管理について説明します。
構成L67-L93ドメイン、DNS、バックエンド（Functions、App Service、Container Apps、APIM）、ビルドとランタイムの設定、ローカルエミュレーション（SWA CLI）、監視、Static Web Apps のデータベースとネットワークの構成について説明します。
統合とコーディングパターンL94-L102Mongoose の使用、接続文字列、一般的な統合パターンなど、Static Web Apps API を Azure データベース（Cosmos DB、SQL、MySQL、PostgreSQL）に接続する方法を説明します。
デプロイL103-L119GitHub／GitLab／Bitbucket／CLI／ARM／Bicep を使用した Static Web Apps のデプロイ、CI/CD の構成、プレビュー環境、トラフィック分割、オプションの Azure Front Door CDN の設定について説明します。
トラブルシューティング
トピックURL
Azure Static Web Apps でよくあるデプロイ時および実行時の問題のトラブルシューティングhttps://learn.microsoft.com/en-us/azure/static-web-apps/troubleshooting
意思決定
トピックURL
Static Web Apps 向けのマネージド Azure Functions と独自の Azure Functions のどちらを選択するかhttps://learn.microsoft.com/en-us/azure/static-web-apps/apis-functions
Azure Front Door と CDN を使用して、Azure Static Web Apps にエンタープライズグレードのエッジ機能を導入するhttps://learn.microsoft.com/en-us/azure/static-web-apps/enterprise-edge
Static Web Apps で Next.js のデプロイモデルを選択するhttps://learn.microsoft.com/en-us/azure/static-web-apps/nextjs
Azure Static Web Apps の Free プランと Standard プランを選択するhttps://learn.microsoft.com/en-us/azure/static-web-apps/plans
制限とクォータ
トピックURL
Azure Static Web Apps の制限と動作に関する詳細https://learn.microsoft.com/en-us/azure/static-web-apps/faq
Azure Static Web Apps でサポートされている言語とランタイムを確認するhttps://learn.microsoft.com/en-us/azure/static-web-apps/languages-runtimes
Azure Static Web Apps のプランのクォータと制限https://learn.microsoft.com/en-us/azure/static-web-apps/quotas
セキュリティ
トピックURL
Microsoft Graph と Entra ID を使用して Static Web Apps のロールを割り当てるhttps://learn.microsoft.com/en-us/azure/static-web-apps/assign-roles-microsoft-graph
Azure Static Web Apps の認証と認可を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/authentication-authorization
Azure Static Web Apps のカスタム認証を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/authentication-custom
Azure Static Web Apps のデプロイトークンを管理およびリセットするhttps://learn.microsoft.com/en-us/azure/static-web-apps/deployment-token-management
Static Web Apps の認証シークレットに Key Vault とマネージド ID を使用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/key-vault-secrets
Azure Static Web Apps の環境でパスワード保護を有効にするhttps://learn.microsoft.com/en-us/azure/static-web-apps/password-protection
Azure Static Web Apps のプライベートエンドポイントアクセスを構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/private-endpoint
Azure Static Web Apps で認証済みユーザー情報にアクセスするhttps://learn.microsoft.com/en-us/azure/static-web-apps/user-information
構成
トピックURL
Azure DNS を使用して Static Web Apps のエイペックスドメインを構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/apex-domain-azure-dns
Static Web Apps のエイペックスドメイン／ルートドメインを外部レジストラーで構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/apex-domain-external
Static Web Apps と Azure API Management の統合を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/apis-api-management
Azure App Service バックエンドを Azure Static Web Apps にリンクするhttps://learn.microsoft.com/en-us/azure/static-web-apps/apis-app-service
Azure Container Apps を Static Web Apps の API として統合するhttps://learn.microsoft.com/en-us/azure/static-web-apps/apis-container-apps
Static Web Apps のバックエンド API のアプリケーション設定を行うhttps://learn.microsoft.com/en-us/azure/static-web-apps/application-settings
Azure Static Web Apps の staticwebapp.config.json を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/configuration
Azure Static Web Apps のカスタムドメインを構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain
Static Web Apps の Azure DNS カスタムドメインを設定するhttps://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-azure-dns
Azure Static Web Apps の既定のドメインルーティングを管理するhttps://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-default
Static Web Apps のカスタムドメインに外部 DNS プロバイダーを使用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-external
Static Web Apps のデータベース接続とファイアウォールを構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-configuration
Static Web Apps のフロントエンドフレームワークのビルド設定を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/front-end-frameworks
既存の Azure Functions アプリを Static Web Apps にリンクするhttps://learn.microsoft.com/en-us/azure/static-web-apps/functions-bring-your-own
Azure Static Web Apps のローカル開発環境を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/local-development
Azure Static Web Apps のマネージド Functions でメトリックを使用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/metrics
Azure Static Web Apps API の Application Insights 監視を有効にするhttps://learn.microsoft.com/en-us/azure/static-web-apps/monitor
Static Web Apps のページに実行時スニペットを挿入するhttps://learn.microsoft.com/en-us/azure/static-web-apps/snippets
Azure Static Web Apps CLI コマンドリファレンスhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli
Azure Static Web Apps CLI で API サーバーを実行してプロキシするhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-api-server
swa-cli.config.json で Azure Static Web Apps CLI を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-configuration
SWA CLI で Azure Static Web Apps をローカルでエミュレートするhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-emulator
Azure Static Web Apps CLI でローカルエミュレーションとワークフローを利用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-overview
インテグレーションとコーディングパターン
トピックURL
Static Web Apps で Mongoose を Azure Cosmos DB と併用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/add-mongoose
Azure Static Web Apps を Azure Cosmos DB に接続するhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-cosmos-db
Azure Static Web Apps を Azure SQL Database に接続するhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-sql
Azure Static Web Apps を Azure Database for MySQL に接続するhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-mysql
Azure Static Web Apps を Azure Database for PostgreSQL に接続するhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-postgresql
デプロイ
トピックURL
Bitbucket でホストされているアプリを Azure Static Web Apps にデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/bitbucket
安定した URL を持つブランチベースのプレビュー環境を作成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/branch-environments
Azure Static Web Apps の CI/CD ビルド YAML を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/build-configuration
外部 CI/CD プロバイダーを使用して Azure Static Web Apps をデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/external-providers
Static Web Apps の CDN として Azure Front Door を手動で構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/front-door-manual
GitLab でホストされているアプリを Azure Static Web Apps にデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/gitlab
Azure Static Web Apps で名前付きプレビュー環境を作成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/named-environments
Azure Static Web Apps でプレビュー環境と一時 URL を使用するhttps://learn.microsoft.com/en-us/azure/static-web-apps/preview-environments
ARM テンプレートを使用して Azure Static Web Apps をデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/publish-azure-resource-manager
Bicep テンプレートを使用して Azure Static Web Apps をデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/publish-bicep
Static Web Apps のプリプロダクション環境を使用してプルリクエストをレビューするhttps://learn.microsoft.com/en-us/azure/static-web-apps/review-publish-pull-requests
Azure Static Web Apps CLI を使用して静的 Web アプリをデプロイするhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-deploy
対応プラットフォームで Azure Static Web Apps CLI をインストールするhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-install
Azure Static Web Apps の環境間でトラフィック分割を構成するhttps://learn.microsoft.com/en-us/azure/static-web-apps/traffic-splitting

コメント

Markdown 対応