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 的 Agent 提供指导，涵盖排障、配置、安全、集成和部署，并结合本地速查内容与远程文档获取。

主要功能

  1. 01排查部署和运行时问题
  2. 02架构选择与方案指导
  3. 03配置身份验证和访问控制
  4. 04设置后端、数据库和域名
  5. 05配置 CI/CD 与预览环境

适用场景

  1. 01诊断构建或运行时故障
  2. 02选择 Functions 托管方式和服务方案
  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 的专业指导，涵盖故障排除、决策、限制和配额、安全性、配置、集成和编码模式，以及部署。它将本地快速参考内容与远程文档获取功能相结合。

如何使用此技能

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

重要提示（面向 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。

类别索引

类别行号说明
故障排除L35-L39诊断并解决 Static Web Apps 常见的部署和运行时问题，包括生成失败、配置问题以及故障排除工具和日志。
决策L40-L47有关关键架构选择的指导：Functions 托管模型、使用 Front Door/CDN 边缘节点、Next.js 部署选项，以及比较 Free 和 Standard Static Web Apps 计划。
限制和配额L48-L54有关计划配额、资源和文件大小限制、支持的语言和运行时，以及 Azure 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-L102介绍如何将 Static Web Apps API 连接到 Azure 数据库（Cosmos DB、SQL、MySQL、PostgreSQL），包括 Mongoose 的用法、连接字符串和典型集成模式。
部署L103-L119通过 GitHub/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 Functionshttps://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
将 Key Vault 和托管标识用于 Static Web Apps 身份验证机密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
配置 Azure API Management 与 Static Web Apps 的集成https://learn.microsoft.com/en-us/azure/static-web-apps/apis-api-management
将 Azure App Service 后端链接到 Azure Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/apis-app-service
将 Azure Container Apps 集成为 Static Web Apps 的 APIhttps://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.jsonhttps://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
使用外部 DNS 提供商配置 Static Web Apps 自定义域名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 Appshttps://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 CLIhttps://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-configuration
使用 SWA CLI 在本地模拟 Azure Static Web Appshttps://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 DBhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-cosmos-db
将 Azure Static Web Apps 连接到 Azure SQL Databasehttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-sql
将 Azure Static Web Apps 连接到 Azure Database for MySQLhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-mysql
将 Azure Static Web Apps 连接到 Azure Database for PostgreSQLhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-postgresql
部署
主题URL
将托管在 Bitbucket 上的应用部署到 Azure Static Web Appshttps://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 构建 YAMLhttps://learn.microsoft.com/en-us/azure/static-web-apps/build-configuration
使用外部 CI/CD 提供商部署 Azure Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/external-providers
手动将 Azure Front Door 配置为 Static Web Apps 的 CDNhttps://learn.microsoft.com/en-us/azure/static-web-apps/front-door-manual
将托管在 GitLab 上的应用部署到 Azure Static Web Appshttps://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 中使用预览环境和临时 URLhttps://learn.microsoft.com/en-us/azure/static-web-apps/preview-environments
使用 ARM 模板部署 Azure Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/publish-azure-resource-manager
使用 Bicep 模板部署 Azure Static Web Appshttps://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 CLIhttps://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