用途
该技能用于 Vercel 的日常运维操作,包括部署和检查 Vercel 应用、分配别名、删除部署、排查日志以及监控部署结果。适用于需要针对 Vercel 平台执行部署与日志相关任务的场景。
主要能力
- 部署与检查 Vercel 应用
- 分配别名(alias)
- 删除部署
- 排查日志
- 监控部署结果
使用方式
解析目标
使用用户明确指定的项目、团队、部署、别名和环境。仅在需要这些默认值时,才使用独立的 jr-rpc config get 命令读取 vercel.project 和 vercel.team;它们是回退值,而非限制。除非被要求,否则不要更改默认值。在写入操作前解析有歧义的目标。仅在明确要求时使用 Production。
工具与 CLI
在 Vercel 目录中发现部署和别名工具,并遵循它们的 schema。对于日志、本地源码上传、其他 Git 提供商或工具未覆盖的操作,使用 CLI。需要时查看 vercel <command> --help。使用 --scope <team> 和明确的目标。
认证由宿主管理。不要设置、打印、复制或请求令牌。绝不要使用其他命令或 API 绕过被拒绝的操作。
验证与失败处理
记录部署 ID、可用的源码提交以及环境。在使用新部署前检查其就绪状态。
在重试不确定的写入前先检查。Vercel 接受写入后可能发生超时。不要盲目重复部署、别名分配或删除操作。
对于 QA,在测试前后比较别名部署 ID。目标发生变化会使受影响的结果不确定。别名检查不是锁。如果分配返回 matches=false,不要覆盖已更改的目标。
在必须不影响共享数据的 QA 之前,验证隔离状态。构建可能运行迁移。移动别名不会停止较旧的 worker。
报告缺失的凭据或提供商权限失败。不要猜测权限范围或更改凭据作为变通方法。
对瞬时读取失败重试一次。限制等待时间并报告未解决的失败。
日志与监控
优先使用带项目、时间窗口和限制的 vercel logs。当前事件默认使用最近一小时,回顾性工作默认使用最近 24 小时。
使用 vercel inspect <deployment> --logs 查看构建日志,使用 vercel list <project> 发现部署。仅引用决定性的诊断信息;日志可能包含私有数据。
仅在明确要求时使用实时日志流,并在收集到证据后停止。
对于监控(watch),调用 vercel_deployment 并传入项目以及可选的团队、目标和完整提交 SHA。使用其返回的资源。除非提供目标,否则提交默认使用 Production。在完成前创建监控;更早的 webhook 事件不会被重放。
适用场景
- 需要部署或检查 Vercel 应用
- 需要分配别名或删除部署
- 需要排查 Vercel 日志
- 需要监控部署结果
限制
- 认证由宿主管理,不能自行设置、打印、复制或请求令牌
- 不能使用其他命令或 API 绕过被拒绝的操作
- 不能猜测权限范围或更改凭据作为变通方法
- 别名检查不是锁,目标可能变化
- 移动别名不会停止较旧的 worker
- 更早的 webhook 事件不会被重放
- 关于收费、价格、平台支持范围等具体信息暂未提供