vercel-deployments

用途

Vercel Deployments 面向需要快速交付 Web 应用的开发者，主要解决前端与全栈应用在 Vercel 上的部署、预览、环境管理和生产防护问题。资料中明确的适用场景包括：

部署 Next.js、SvelteKit、Nuxt 或静态站点
为每个 PR 设置预览环境
配置边缘函数与无服务器 API
跨预览/生产环境管理环境变量
设置自定义域名和重定向

主要能力

该技能覆盖以下几类能力：

部署与发布：通过 CLI 部署到预览环境或生产环境，支持回滚、将预览提升为生产。
项目配置：通过 vercel.json 定义框架、构建命令、输出目录、安装命令、区域，以及响应头、重定向和重写规则。
环境变量管理：支持为 production、preview、development 分别添加变量，列出变量、拉取到本地 .env.local、删除变量。资料给出环境分离模式，生产使用真实凭据，预览使用暂存/测试凭据（例如 Stripe 测试模式密钥），开发使用本地值。
边缘函数与中间件：示例包含边缘 API 路由（利用 request.geo 获取国家、城市、区域信息）与边缘中间件（用于鉴权/重定向、添加安全响应头）。
CI/CD 集成：提供 GitHub Actions 工作流示例，在 pull_request 时执行安装、lint、测试，再部署到 Vercel 预览，并把预览 URL 评论到 PR 上。
CLI 命令参考：涵盖部署、回滚、提升、域名与证书管理、日志查看、项目管理与部署检查。
生产防护栏：建议包括在合并前要求预览检查、分离预览与生产环境变量、使用分支保护与必需的部署状态检查、在 Vercel Analytics 中监控函数时长与冷启动、在仪表盘设置支出限额、启用 Vercel Firewall 防护 DDoS 与机器人、使用 vercel.json 响应头设置安全策略（CSP、HSTS、X-Frame-Options）。
监控与分析：通过安装 @vercel/speed-insights 与 @vercel/analytics，并在应用布局中挂载组件来启用。

使用方式

资料给出的使用方式以 CLI 为主：

安装 CLI：npm i -g vercel
登录并关联项目：vercel login、vercel link
部署到预览：vercel
部署到生产：vercel --prod
拉取环境变量到本地：vercel env pull .env.local

环境变量的添加、列出、拉取与删除分别使用 vercel env add、vercel env ls、vercel env pull、vercel env rm。项目配置写入 vercel.json，可定义 framework、buildCommand、outputDirectory、installCommand、regions、headers、redirects、rewrites。边缘函数通过在路由文件中导出 runtime = 'edge' 实现；中间件通过 middleware.ts 导出 middleware 函数与 config.matcher 配置。

前置条件与限制

前置条件包括 Node.js 18+、Vercel 账号（个人项目可使用免费层）、以及 Git 仓库（GitHub、GitLab 或 Bitbucket）。

资料中提到的限制与注意事项：

边缘函数有 30 秒超时限制，重型任务应移到无服务器函数（不设置 runtime = 'edge'）。
冷启动慢可通过尽可能使用边缘运行时、减小打包体积来缓解。
构建失败应检查 vercel logs 并在 engines 字段中核对 Node.js 版本。
环境变量缺失可运行 vercel env pull，并检查变量作用域（预览 vs 生产）。
域名不工作时检查 DNS 传播并核对 vercel domains 配置。

技能介绍

用途

主要能力

使用方式

前置条件与限制

相关资料