第28章 Deployments(部署)
部署
v0 的第 0 版本将项目部署到 Vercel。工作分支会生成预览部署供审查;发布操作则会更新该 Vercel 项目的生产部署及其稳定的生产环境 URL。
预览部署与生产部署
预览部署从工作分支构建,拥有唯一的 URL,不会影响项目的生产环境 URL。 生产部署服务于项目的域名。发布操作通过项目配置的 Git 和 Vercel 工作流,将当前工作推广至生产环境。
对于基于 GitHub 的项目,点击“发布”旁边的分支按钮即可查看工作分支的预览状态。菜单中会显示部署状态、分支差异、Pull Request 及 CI 检查结果。对于未连接 GitHub 的项目,直接打开“发布”以查看最新部署。
首次发布
在聊天界面顶部选择“发布”。首次发布流程将引导你完成项目所需的设置:
- 创建项目:如果当前聊天尚未关联 Vercel 项目,请确认 Vercel 项目名称。 - 可见性:选择可访问已部署应用的人员范围。可选范围取决于团队套餐及部署保护设置。 - 域名:确认提供的 vercel.app 域名,选择已连接的自定义域名,或前往 Vercel 添加新域名。 - 商务模式(如适用):检查未认领的 Stripe 测试沙盒或 Shopify 开发商店,并决定在发布前是否认领这些资源。 - 发布:启动生产部署。
每个 Vercel 项目都有一个稳定的生产 URL。后续的生产部署会更新该 URL 下的应用,但 URL 本身保持不变。
发布更新
在进行其他代码更改后:
1. 打开“发布”菜单。 2. 审查生产部署及所选域名。 3. 选择“发布更改”。
对于基于 GitHub 的项目,发布操作会创建或复用 Pull Request,将其合并到聊天基础分支,并等待生产部署完成。GitHub 分支保护规则依然生效。详见“GitHub → 通过 GitHub 发布更改”。 未连接 GitHub 的项目会将当前聊天的代码直接部署到关联的 Vercel 项目。
部署状态与操作
部署卡片实时报告构建进度及最终状态。根据具体部署情况,卡片还会链接至:
- 已部署的网站 - 对应的 Commit 或工作分支 - Vercel 中的部署检查器 - 构建日志及错误信息
对于基于 GitHub 的项目,分支菜单还会报告 CI 及 Pull Request 的状态。其 v0 操作会根据当前问题动态变化,选项包括:审查代码、修复构建、修复 CI、解决冲突,或同时修复 CI 与冲突。
域名与可见性
你可以从 v0 更改部署设置:
- 打开“项目”菜单... → “设置” → “域名”以管理项目域名。 - 打开“项目”菜单... → “设置” → “Vercel 项目”以管理生产环境可见性。
在首次发布期间,请在发布流程中选择可见性和域名。
高级 DNS 配置、重定向及其他域名设置需在 Vercel 仪表盘中操作。详见“自定义域名”。
高级部署设置
点击部署检查器链接可管理 Vercel 项目,包括:
- 构建与部署设置 - 生产、预览及开发环境的环境变量 - 部署保护与 Vercel 身份验证 - Web 分析与性能洞察 - 运行时日志与可观测性 - 回滚与重新部署
完整的控制选项请参阅“Vercel 项目配置”。
部署策略
团队可配置“部署策略”,以限制允许创建部署的 Git 来源及部署机制。如果策略阻止了针对目标环境的 v0 部署,团队所有者必须在团队层级允许该来源,或覆盖该项目的策略。
故障排除
预览或生产构建失败 当部署出现错误或警告时,选择“通过 v0 修复”或“修复构建”。v0 将读取相关日志,诊断故障原因并应用修复。在付费计划下,针对未修改代码的每日免费使用次数上限为 10 次;超出后,修复操作将像常规提示词一样消耗积分。详见“代理功能 → 通过 v0 修复”。 如有需要,可让 v0 回滚更改或恢复先前的聊天版本,然后再次发布。
GitHub 发布受阻 打开分支菜单以检查 CI 及 Pull Request 状态。v0 可以处理可操作的 CI 失败及合并冲突。必需的代码审查及其他人工审批规则必须在 GitHub 上完成后,才能再次发布。
团队禁用了发布功能 请检查团队的部署策略及你的 Vercel 项目权限。发布还要求具备可编辑聊天的 v0 角色权限,以及部署到关联 Vercel 项目的权限。
预期域名缺失 打开“项目”菜单... → “设置” → “域名”,确认该域名属于关联的 Vercel 项目。未验证的域名必须在 Vercel 中完成验证后才能选择。
后续步骤
- 连接 GitHub 并通过分支发布 - 添加自定义域名 - 配置环境变量 - 设置 Web 分析
前文:Slack 下文:自定义域名