mcpField
D
deploying-cloudflare-web-application

deploying-cloudflare-web-application

github.com/cedmandocdoc云与 DevOps040 次安装2 天前更新
代码仓库

关于 deploying-cloudflare-web-application

用于通过 GitHub Actions 准备和管理 Cloudflare Web 应用部署的技能，涵盖环境检查、部署、密钥、直接运行或回滚及故障排查；Cloudflare 变更通过推送工作流执行。

主要功能

  1. 01引导检查依赖与账户设置
  2. 02提供应用和数据库部署方案
  3. 03指导配置 GitHub Actions 密钥
  4. 04支持直接部署与回滚流程
  5. 05排查部署故障

适用场景

  1. 01检查 Cloudflare 部署是否就绪
  2. 02添加部署工作流或 D1 数据库
  3. 03合并前确认所需密钥
  4. 04调查部署失败或刷新时出现的 404

安装

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

$npx skills add https://github.com/cedmandocdoc/awesome-skills --skill deploying-cloudflare-web-application

安装后在 Claude Code 中输入/deploying-cloudflare-web-application确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
ci-token-permissions.tsv
deployment.md
references/
configuring-github-actions.md
configuring-secrets.md
configuring-wrangler.md
deploying-application.md
deployment-contract.md
discovering-application.md
executing-direct-deploy.md
troubleshooting-deployment.md
scripts/
probe-ci-token.sh

详细介绍

将 Web 应用部署到 Cloudflare

设置

项目类型必需适用时机完成条件方法
Node.js 22+ 和项目使用的包管理器用户必需全部node --version 输出 v22 或更高版本，且锁文件对应的包管理器（npm、pnpm、yarn）可正常运行https://nodejs.org
GitHub CLI用户必需部署、密钥、运行或回滚gh auth status 成功，且 gh repo view 能找到该仓库https://cli.github.com，然后运行 gh auth login；创建 GitHub 仓库并推送项目
Cloudflare 账户用户必需全部npx wrangler whoami 显示一个账户在 https://dash.cloudflare.com/sign-up 注册，然后运行 npx wrangler login
账户 ID询问必需部署wrangler 配置中已设置 account_idnpx wrangler whoami 显示一个账户 → 使用该账户；显示多个账户 → 询问使用哪个；在 wrangler 配置中记录为 account_id
CI API 令牌用户必需密钥configuring-github-actions.md → Probe 显示已授予所有权限按照 configuring-github-actions.md → CI API token 中的说明操作

工作流

  1. 设置 — 按顺序处理所有适用请求的 设置 行：满足完成条件 → 跳过；user → 如果必需则停止并打印其方法，如果可选则不使用并继续；ask → 填写请求中已回答的内容，将其余问题合并到一条消息中询问，并记录每个答案；auto 和 static → 执行。
  2. 契约 — 阅读 deployment-contract.md。
  3. 方案 — 匹配一行 方案；打开其“阅读”列中的所有文档。
  • 只写入仓库文件；Cloudflare 更改会在推送到生产分支时通过部署工作流执行。CI 令牌探测会在随后删除的临时分支上运行。
  • 仅使用 wrangler login 会话在本地运行 Wrangler 读取状态，绝不使用导出的 CLOUDFLARE_API_TOKEN。
  • 不设置任何密钥，只读取密钥名称；所有密钥均由用户在 GitHub 中设置。

方案

意图示例表述阅读
设置“设置 Cloudflare 部署”，“deploying-cloudflare-web-application 准备好了吗？”设置 — 对每一行执行工作流步骤 1，然后报告每行的状态
部署“将 Web 应用部署到 Cloudflare”，“添加 Cloudflare 部署工作流”，“添加 D1 数据库”，“绑定自定义域名”，“从单体仓库部署 apps/web”deploying-application.md
密钥“部署需要哪些密钥？”，“添加 Worker 密钥”，“Cloudflare 部署准备好合并了吗？”configuring-secrets.md
运行或回滚“现在部署，不要推送”，“回滚 Worker”，“当前运行的是哪个版本？”executing-direct-deploy.md
故障排查“Cloudflare 部署工作流失败”，“部署后刷新页面出现 404”troubleshooting-deployment.md

评论

支持 Markdown