Orbit
Orbit部署管道
The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…
Pipeline 标签页是一个单页面,回答"我们推送时会发生什么"这个问题。它展示触发部署的每一种方式、可以阻止部署的每一道关卡、每个环境的状态,以及哪些构建功能已打开,所有信息都来自你的项目的实际配置。
Pipeline 的位置
打开 Orbit,点击项目,然后在项目标签栏的 Deployments 组下选择 Pipeline。该页面标记为 Deployment pipeline。
它是一个只读仪表板。此处不配置任何内容;每个部分都链接到设置实际所在的位置。这就是它的价值所在:一个屏幕来理解项目,而不是读八张设置卡片。

顶部的警报
有两个横幅在适用时出现:
- Deploy lock active,带有 Manage 链接。推送触发的部署被跳过。
- N deployments awaiting approval,带有 Review 链接。需要有人批准或拒绝它们。
如果其中任何一个显示,而你想知道为什么推送没有部署,你会在不往下读的情况下得到答案。
构建统计
一个紧凑的面板显示最近构建的情况:成功率、平均构建时间和成功的构建数。它是一个健康检查,而不是分析。了解完整情况,请参阅 Orbit Project Analytics 和 Orbit Build Insights。
触发源
此部分列出此项目部署的每一种途径:
| 源 | 显示内容 |
|---|---|
| Git push | 连接的存储库,或 No repo connected |
| Branch previews | 是否在任何分支上自动创建预览 |
| Git tag | 配置的标签模式(如果有的话) |
| Manual deploy | 总是可用 |
每当你对部署感到惊讶时,请阅读此部分。如果构建出现但没有人推送,以下其中之一是解释:一个标签、一个部署钩子,或某人按了一个按钮。
关卡和安全性
最大的部分是关卡列表,每个关卡显示其当前状态和 Configure 链接,指向相关的设置卡片。
| 关卡 | 功能 |
|---|---|
| Approval gate | 生产部署需要明确批准 |
| Staging prerequisite | 生产环境需等待相同提交的测试环境 |
| CI checks | 必须通过的必需检查,或 No checks required |
| Freeze window | 周末被阻止、自定义小时或没有冻结计划 |
| Deploy lock | 活跃或无锁 |
| Health check | 部署后检查的路径,或 Disabled |
| Auto-rollback | 在健康检查失败时回滚 |
| Skew protection | 旧资产的保留窗口 |
| Auto retry | 基础设施故障重试次数 |
这些关卡中的大多数仅适用于推送触发的部署。面板中的手动部署和部署钩子直接通过。异常情况的行为不同,每个关卡的细节在 Deploying Your Project 中介绍。在依赖关卡作为控制之前,请阅读该文档。
将关卡作为检查清单读取
对于重要的项目,合理的基准是:
- Health check:已设置,指向锻炼应用的路径,而不是缓存的 shell。
- Auto-rollback:打开。没有健康检查,它无法采取行动,所以这两者是相辅相成的。
- Auto retry:一到两次。它重新队列基础设施错误(如网络故障)导致的构建失败,不重试代码错误,所以除了节省时间外对你没有成本。
- Approval gate:对于坏部署成本高的任何事物打开,对于减速超过保护的关闭。
如果页面显示健康检查 Disabled 和自动回滚已打开,该组合不起作用。这是几个月都不会注意到的最容易的错误配置之一,此页面是你发现它的地方。
环境流
Environment flow 部分将每个环境绘制为一张卡片,显示其当前状态:LIVE、BUILDING 或 PAUSED,它跟踪的分支,以及如果当前部署是重试则显示重试号。
每张卡片上的徽章显示为该环境启用的功能:
- Smoke tests,在每次成功部署后针对选定路径运行的 GET 请求。
- Auto-promote,在多个健康小时后将测试环境提升到生产环境。
- Canary,金丝雀部署的流量百分比。
- Inherits prod vars,其中测试环境以较低优先级合并生产环境变量。
- Scheduled rebuild,生产环境按间隔重新构建。
每张卡片链接到该环境的部署。如果环境显示 No deployments yet,它存在于配置中但没有内容已部署到它。
活跃功能
最后一部分总结构建级别的设置:
| 功能 | 值 |
|---|---|
| Server mode | SSR 启用或仅静态 |
| Auto-create on push | 分支推送是否创建环境 |
| Health checks | 打开或关闭 |
| Build retry | 最大次数或关闭 |
| Deploy groups | 与其他项目分组或独立 |
| Build timeout | 每个构建的限制 |
| Preview expiry | 预览暂停前的天数或永不 |
Server mode 是人们容易遇到的。在服务器上渲染的框架需要打开它;静态导出则不需要。如果你的项目构建良好,然后在除主页外的每个路由上提供空白页面或 404,首先检查此项。请参阅 Frameworks Orbit Supports。
Preview expiry 是管理的。设置为永不,预览环境会无限期地累积。
使用 Pipeline 页面
当新手入职时。 先把他们送到这里。这比任何文档都更快更准确的简报,因为它是由实时配置生成的。
当部署没有发生时。 从上往下工作:横幅、然后触发源、然后关卡。其中之一会解释它。
在风险发布之前。 检查关卡部分是否按你认为的方式读取。这是相信你有自动回滚和拥有它之间的区别。
在事件期间。 环境流告诉你什么在何处是实时的,以及是否有什么正在中途构建。
故障排除
页面显示 No repo connected。 项目没有存储库。连接一个:请参阅 Connecting a GitHub Repository。
一个关卡已打开但部署仍然通过。 它只是推送触发的。部署钩子或手动面板部署不受影响。
环境显示 PAUSED。 预览环境在超过过期后自动暂停。重新部署以恢复一个。
Auto-promote 显示但没有提升。 它需要配置数量的健康小时且烟雾测试通过,并且是定期评估而不是即时的。
下一步去哪里
- Deploying Your Project 了解每个关卡实际阻止什么。
- Orbit Project Settings 更改任何内容。
- Rolling Back a Deployment 当关卡没有保护你时。