SuperAPI AI 工具集

vercel-github-actions

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:整理使用 GitHub Actions 将项目部署到 Vercel 的 CI/CD 模式,覆盖预览、预发、生产三套环境。

主要能力:三环境模型(Preview 对应 feature/* 分支、按 PR 自动生成且临时;Staging 对应 staging 分支、持久 URL 供 UAT;Production 对应 main 分支、面向用户)。Vercel CLI 覆盖登录与链接(vercel login、vercel link)、拉取环境变量(vercel env pull,可指定 production/preview)、部署(vercel、vercel --prod、vercel build、vercel deploy --prebuilt 及 --prod)。别名管理用于生成持久 URL(vercel alias、vercel alias ls、vercel alias rm),需注意别名指向具体部署而非分支,每次 staging 部署后需手动或经 CI 更新。回滚与提升包括 vercel rollback、vercel promote、vercel ls。域名命令为 vercel domains add/ls/inspect。

使用方式:GitHub Actions 需配置 VERCEL_TOKEN、VERCEL_ORG_ID、VERCEL_PROJECT_ID 三个 Secrets,后两者取自 vercel link 生成的 .vercel/project.json。资料给出 Preview、Production、Staging(含别名更新)、E2E 测试四类工作流示例,通用步骤为 checkout、setup-node、npm ci、全局安装 vercel、vercel pull、vercel build、vercel deploy --prebuilt 并在 PR 中评论部署 URL。vercel.json 可配置 framework、buildCommand、headers(如 X-Frame-Options、HSTS),使用自定义 Actions 工作流时应设 github.enabled: false 以避免重复部署。

适用场景与限制:适用于以 Vercel 托管、用 GitHub Actions 做自动部署与预览的项目。安全上不要提交含敏感数据的 .vercel/project.json,不在日志中输出密钥,定期轮换 VERCEL_TOKEN。常见问题包括域名未配置、CI 与本地 Node 版本或环境变量不一致、部署成功但站点报错等;具体修复步骤以资料所述排查项为准,未提供的细节暂未提供。