SuperAPI AI 工具集

vercel-deploy-preview

部署与运维

查看项目

更新于 10-15 23:30

技能介绍

用途:为分支和拉取请求创建预览部署环境。每次向非生产分支推送代码都会生成唯一的预览 URL,便于在合并前测试改动。

主要能力:支持通过 CLI 部署预览(vercel 默认即预览,非 --prod;可指定目录 vercel ./dist;CI 中可用 vercel --no-wait 立即返回部署 URL);支持通过 REST API 创建部署(POST https://api.vercel.com/v13/deployments,target 设为 preview,可指定 gitSource 的仓库、分支与提交);可轮询部署状态(QUEUED → BUILDING → READY,或 ERROR/CANCELED);可添加仅作用于 preview 的环境变量(vercel env add DATABASE_URL preview,或通过 API 设置 target 为 preview);支持部署保护(vercel.json 中 deploymentProtection.preview 可设为 vercel-authentication 或 standard-protection,后者可用 x-vercel-protection-bypass 头绕过);连接 GitHub 后会自动在每次推送创建预览、在 PR 中评论预览 URL、更新提交状态并添加 Visit Preview 链接。

使用方式:需先完成 vercel-install-auth 设置、通过 vercel link 关联项目,并在 Vercel 控制台连接 Git 仓库。预览 URL 有固定模式,如分支 feature/auth 对应 my-app-git-feature-auth-team.vercel.app。

适用场景:PR 合并前测试、CI 流水线中的自动化预览与冒烟测试。

限制与错误处理:常见错误包括 BUILD_FAILED(用 vercel inspect 查看日志)、FUNCTION_INVOCATION_FAILED(用 vercel logs 查看)、NO_BUILDS(检查 outputDirectory)、预览未更新(用 vercel --force 强制重建)、DEPLOYMENT_BLOCKED(使用绕过头)。使用绕过令牌时不应泄露密钥,并应在评审窗口后使预览过期。资料未提供具体收费与价格信息。