Azure Integrations 是一套面向 Azure 云服务的部署与集成模式技能,主要用于把 Web 应用部署到 Azure,并建立可复现的 CI/CD 与基础设施即代码流程。技术栈目标包括 Azure Static Web Apps、App Service、Bicep 或 ARM 模板、GitHub Actions、Node.js 20+ 与 Azure CLI 2.60+。
适用场景:将 Next.js 或 Vite/React 应用部署到 Azure;用 GitHub Actions 搭建 CI/CD;配置 Static Web Apps 或 App Service;用 Blob Storage 管理文件上传;用 Key Vault 管理机密;配置 Application Insights 监控;编写 Bicep/ARM 模板;以及把 Azure Cosmos DB(MongoDB API)与应用集成。
主要能力与用法:文档给出 Static Web Apps 的 GitHub Actions 工作流(Azure/static-web-apps-deploy@v1,设置 app_location、api_location、output_location)、staticwebapp.config.json 的路由与导航回退、安全头与 401 重定向配置;App Service 的端到端指南涵盖部署槽零停机、Key Vault、托管标识、Application Insights、带 CORS 的 Storage、Bicep 模板与 GitHub Actions。示例脚本包括 scripts/deploy-swa.ps1 与 scripts/deploy-appservice.ps1,后者用法示例为 .\deploy-appservice.ps1 -AppName "my-app" -ResourceGroup "rg-my-app" -Sku S1 -EnableAppInsights -EnableStorage。基础设施可用 az deployment group create 部署 Bicep 模板。Blob 上传示例基于 @azure/storage-blob,提供 uploadFile、deleteFile、generateSasUrl。
跨客户端与 MCP:技能可在 GitHub Copilot、Claude Code、Codex 中使用;Codex 需将文件夹同步到 $CODEX_HOME/skills/azure-integrations。首选 MCP 服务为 Azure MCP,不可用时回退到 Azure CLI、Bicep/ARM 与随附 PowerShell 脚本,且不得声称使用了宿主未暴露的 MCP 操作。
限制与校验:禁止在未检查现状前改动基础设施、禁止硬编码凭据;声明应用成功前需确认目标运行时、框架版本与受影响文件,运行构建/测试等本地校验,并处理错误、依赖漂移与环境差异等边界情况。故障排查涉及 output_location 不匹配、az webapp log tail 查看日志、存储 CORS、az bicep build --file main.bicep 校验等。