Vercel 部署与 CI 流水线
给出 Vercel 项目和目标环境,产出可执行的部署命令或 CI 工作流配置
功能与用途
面向 Vercel 项目部署与流水线编排的实操指南。详细梳理 vercel deploy、--prod、promote、rollback、inspect 与 build 等核心 CLI 命令的适用场景与区别,重点解析 --prebuilt 模式在自定义构建及缓存加速中的应用。提供 GitHub Actions、GitLab CI 和 Bitbucket Pipelines 的完整工作流配置范式与环境变量规范,明确 OIDC 联邦在跨云后端免密访问与 CLI Token 之间的职责边界,并针对 ERR_PNPM_OU
适用场景
- 每个 PR 想要一个预览地址并自动把链接评论到 PR 里,测:每个 PR 想要一个预览地址并自动把链接评论到 PR 里,测试过了再切生产
- CI 上每次重新远程构建太慢,想把构建放到流水线里做缓存和测:CI 上每次重新远程构建太慢,想把构建放到流水线里做缓存和测试关卡
- 线上版本有问题,需要立刻回退到上一个生产部署而不是重新构建:线上版本有问题,需要立刻回退到上一个生产部署而不是重新构建
- 构建报 ERR_PNPM_OUTDATED_LOCKFILE:构建报 ERR_PNPM_OUTDATED_LOCKFILE 或 NEXT_NOT_FOUND,想快速定位是锁文件还是根目录配置的问题
适用人群
- 用 Vercel 托管前端的前端开发
- 负责搭建团队发布流水线的 DevOps 工程师
- 维护 monorepo 构建配置的技术负责人
使用步骤
- 说明你的项目用的是 Vercel 的哪套流程,以及这次是要发预览、发生产还是回退。
- 我给出对应的 CLI 命令,并区分 promote(瞬间切别名不重建)和重新部署的区别。
- 要配 CI 的话,先把 VERCEL_TOKEN、VERCEL_ORG_ID、VERCEL_PROJECT_ID 三个变量设为 secrets。
- 按你用的平台(Actions / GitLab / Bitbucket)给出完整工作流,CI 里统一走 build 加 --prebuilt。
- 构建失败时对照报错表定位原因,例如锁文件不一致或根目录配置错误。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Vercel deployment and CI/CD expert guidance. Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel.
使用前准备
- 需要 Vercel 项目、安装 Vercel CLI,并在 CI 中配置 VERCEL_TOKEN 等三个环境变量
依赖与权限
- VERCEL_TOKEN
- 读取用户主动提供的内容