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, нажмите на проект и выберите Pipeline в группе Deployments на полосе вкладок проекта. Страница помечена как Deployment pipeline.
Это приборная панель только для чтения. Здесь ничего не настраивается; каждый раздел ссылается на то место, где на самом деле находится параметр. В этом его ценность: один экран для понимания проекта, а не чтение восьми карточек параметров.
Предупреждения в верхней части
Два баннера появляются, когда они применимы:
- Deploy lock active, со ссылкой Manage. Развёртывания, инициируемые отправками кода, пропускаются.
- N deployments awaiting approval, со ссылкой Review. Кто-то должен одобрить или отклонить их.
Если любой из них отображается и вы интересуетесь, почему отправка кода не привела к развёртыванию, здесь вы найдёте ответ без дальнейшего чтения.
Статистика сборок
Компактная панель показывает за недавние сборки: процент успеха, среднее время сборки и сколько их удалось. Это проверка здоровья, а не анализ. Для полной картины см. Аналитика проекта Orbit и Insights сборок Orbit.
Источники запусков
В этом разделе перечислены все пути запуска развёртывания для этого проекта:
| Источник | Что он показывает |
|---|---|
| Git push | Подключённый репозиторий или No repo connected |
| Branch previews | Создаются ли превью автоматически на любой ветке |
| Git tag | Шаблон тега, если он настроен |
| Manual deploy | Всегда доступно |
Прочитайте этот раздел всякий раз, когда вы удивлены развёртыванием. Если сборка появилась и никто не отправлял код, объяснение находится в одном из них: тег, хук развёртывания или нажатие кнопки кем-то.
Ворота и безопасность
Самый большой раздел, это список ворот, каждый из которых показывает своё текущее состояние со ссылкой Configure на соответствующую карточку параметров.
| Ворота | Что они делают |
|---|---|
| Approval gate | Развёртывания в production требуют явного одобрения |
| Staging prerequisite | Production ждёт staging на том же коммите |
| CI checks | Обязательные проверки, которые должны пройти, или No checks required |
| Freeze window | Выходные заблокированы, пользовательские часы или нет расписания замораживания |
| Deploy lock | Активно или без блокировки |
| Health check | Путь, проверяемый после развёртывания, или Disabled |
| Auto-rollback | Откатывается при отказе проверки здоровья |
| Skew protection | Окно удержания старых активов |
| Auto retry | Количество повторов попыток при сбоях инфраструктуры |
Большинство этих ворот применяются только к развёртываниям, инициируемым отправками кода. Ручные развёртывания с панели и хуки развёртывания проходят прямо сквозь. Исключение ведёт себя иначе, и детали каждого ворота рассмотрены в разделе Развёртывание вашего проекта. Прочитайте это перед тем, как полагаться на ворота как на управление.
Чтение ворот как контрольного списка
Для проекта, который имеет значение, разумная базовая конфигурация:
- Health check: установлен, указывает на путь, который проверяет приложение, а не кэшированную оболочку.
- Auto-rollback: включён. Без проверки здоровья он ничего не может сделать, поэтому эти два параметра идут вместе.
- Auto retry: один или два. Это повторно ставит в очередь сборки, которые не удались из-за ошибок инфраструктуры, таких как сбой сети, и не повторяет ошибки кода, поэтому это ничего не стоит вам, кроме сэкономленного времени.
- Approval gate: включён для всего, где неудачное развёртывание дорого стоит, выключен где оно замедляет вас больше, чем защищает.
Если на странице отображается Health check Disabled и Auto-rollback включён, эта комбинация ничего не делает. Это одна из самых простых неправильных конфигураций, которую можно носить месяцами, не заметив, и эта страница, именно то место, где вы её заметите.
Поток окружения
Раздел Environment flow рисует каждое окружение как карточку с его текущим состоянием: LIVE, BUILDING или PAUSED, ветка, которую оно отслеживает, и номер повтора, если текущее развёртывание является повтором.
Значки на каждой карточке показывают, что включено для этого окружения:
- Smoke tests, GET-запросы, запущенные по выбранным путям после каждого успешного развёртывания.
- Auto-promote, повышение staging до production после определённого количества здоровых часов.
- Canary, процент трафика при развёртывании canary.
- Inherits prod vars, где staging объединяет переменные среды production с более низким приоритетом.
- Scheduled rebuild, где production перестраивается по расписанию.
Каждая карточка ссылается на развёртывания этого окружения. Если окружение показывает No deployments yet, оно существует в конфигурации, но ничего в него не было развёрнуто.
Активные функции
Последний раздел резюмирует параметры уровня сборки:
| Функция | Значения |
|---|---|
| Server mode | SSR включён или только статичный |
| Auto-create on push | Создают ли отправки веток окружения |
| Health checks | Включено или выключено |
| Build retry | Максимум или выключено |
| Deploy groups | Сгруппировано с другими проектами или автономно |
| Build timeout | Лимит на сборку |
| Preview expiry | Дни до паузы превью или никогда |
Server mode, это то, на чём люди ловятся. Фреймворк, который отрисовывает на сервере, нуждается в его включении; статичный экспорт, нет. Если ваш проект собирается хорошо, а затем показывает пустую страницу или 404 на каждом маршруте кроме домашней страницы, проверьте это в первую очередь. См. Фреймворки, которые поддерживает Orbit.
Preview expiry, это управленческий параметр. Если установить на никогда, окружения превью накапливаются бесконечно.
Использование страницы Pipeline
При подготовке нового сотрудника. Отправьте его сюда в первую очередь. Это более быстрое и точное введение, чем любой документ, потому что оно генерируется из живой конфигурации.
Когда развёртывание не произошло. Работайте сверху вниз: баннеры, затем источники запусков, затем ворота. Один из трёх объяснит это.
Перед рискованным релизом. Проверьте, что раздел ворот читается так, как вы думаете. Это разница между верой в то, что у вас есть auto-rollback и его наличием.
Во время инцидента. Поток окружения показывает вам, что запущено где, и строится ли что-то в данный момент.
Устранение неполадок
На странице отображается No repo connected. Проект не имеет репозитория. Подключите его: см. Подключение репозитория GitHub.
Ворота включены, но развёртывания всё равно идут. Это только для отправок кода. Хук развёртывания или ручное развёртывание с панели не затрагиваются.
Окружение показывает PAUSED. Окружения превью автоматически приостанавливаются после истечения срока действия. Повторно развёртывание, чтобы вернуть его.
Auto-promote показан, но ничего не повышается. Это требует настроенного количества здоровых часов с прошедшими smoke tests и оценивается периодически, а не мгновенно.
Куда дальше
- Развёртывание вашего проекта для того, что каждый из ворот фактически блокирует.
- Параметры проекта Orbit чтобы изменить что-либо из этого.
- Откат развёртывания когда ворота вас не спасли.