Orbit
Просмотр журналов сборки
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Каждое развертывание Orbit сохраняет полный журнал сборки, а также структурированную разбивку того, что сборка выполнила и сколько времени заняла каждый этап. В этом руководстве описано, где найти журнал, как читать прилагаемые метаданные и анализ, который Orbit выполняет над журналом для вас.
Просмотр журнала для последнего развертывания
Откройте проект в Orbit. Панель Latest build на вкладке Overview показывает журнал самого последнего развертывания. Если сборка выполняется в данный момент, журнал передается в реальном времени, строка за строкой, по мере того как агент сборки ее производит.
Нажмите Full details, чтобы открыть полную страницу сведений о развертывании.
Просмотр журналов для конкретного развертывания
- Откройте проект в Orbit.
- Откройте вкладку Deployments.
- Нажмите любое развертывание, чтобы открыть его страницу сведений.
- Полный журнал сборки находится на этой странице.
Список Recent deployments на вкладке Overview содержит ссылку View logs в каждой строке, которая ведет на то же место. Предварительные развертывания содержат ту же ссылку в разделе Preview deployments.
Фазы сборки
Страница сведений разбивает сборку на именованные фазы с длительностью для каждой:
| Фаза | Что происходит |
|---|---|
| Clone | Получение вашего репозитория в момент развертываемого коммита |
| Cache restore | Распаковка кэшированного node_modules на планах с кэшем сборки |
| Install | Запуск команды установки |
| Cache save | Переупаковка node_modules для следующей сборки |
| Build | Запуск команды сборки |
| Upload | Упаковка выходного каталога и сохранение артефакта |
| Done | Артефакт находится перед трафиком |
Это самый быстрый способ ответить на вопрос "почему эта сборка была медленной". Длинная фаза Install с значком Cold build означает, что кэш был пропущен. Длинная фаза Build означает, что ваша собственная сборка работала медленнее.
Метаданные сборки
Карточки выше журнала показывают факты о развертывании:
| Карточка | Что она показывает |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back или Awaiting approval |
| Commit | Коммит, который это развертывание собрало, со ссылкой на поставщика |
| Branch | Ветка git, из которой он пришел |
| Author | Кто отправил коммит |
| Build time | Общее время по стене с рейтингом Fast, Normal или Slow для вашей собственной истории |
| Artifact | Размер упакованного вывода со ссылкой для загрузки |
| Framework | Фреймворк, обнаруженный Orbit |
| Package manager | npm, yarn или pnpm, обнаруженные из вашего файла блокировки |
| Build cache | Cache hit или Cold build |
| Build host | Какой хост сборки его запустил |
| Queue position | Ваше место в очереди, пока развертывание еще в очереди |
| Pull request | Номер PR для предварительного развертывания |
| Health score | Оценка из 100 с указанными вычетами |
Анализ, который Orbit выполняет над журналом
Страница сведений, это не просто текстовый дамп. Orbit анализирует журнал и показывает то, что важно.
- Build timeline с длительностью на каждый этап.
- Slow build detected, когда сборка значительно медленнее, чем ваша собственная медиана, с процентом и типичным временем из последних 10 сборок.
- TypeScript errors, извлеченные и подсчитанные, когда сборка не прошла проверку типов.
- Build analysis для сборок Next.js: размеры на каждый маршрут, начальный JS и статические, динамические и ISR количество маршрутов.
- Bundle regression предупреждения, когда первоначальный JS маршрута увеличивается более чем на 20% по сравнению с предыдущим развертыванием или общий пакет JS увеличивается.
- npm audit результаты, разобранные прямо из выходных данных установки, суммированные по серьезности.
- Security headers audit оценена из 60 баллов.
- Smoke test результаты, если вы настроили пути дымных тестов.
- Performance budgets превышены, если вы установили бюджеты.
- Build optimization advisor, перечисляющий конкретные изменения с приблизительной экономией размера, ранжированные по влиянию.
- Real user metrics, p75 Core Web Vitals, зафиксированные, пока это развертывание было в сети.
Какие переменные среды фактически видела сборка
Страница сведений содержит список ключей переменных среды, которые были внедрены во время сборки, и сравнивает их с вашей текущей конфигурацией: добавлены, изменены, удалены, неизменены. Голубые ключи пришли из переопределения, зависящего от окружения, серые из уровня проекта.
Значения никогда не сохраняются и никогда не отображаются. При наведении курсора на ключ вы получите отпечаток SHA-256, которого достаточно, чтобы подтвердить, что два окружения имеют одно и то же значение, не раскрывая его.
Это сравнение, самый быстрый способ ответить на вопрос "действительно ли мое изменение переменной среды попало в сборку". Если развертывание датировано до изменения, Orbit указывает это уведомлением Environment variables updated since this deployment и напоминает, что изменение не вступит в силу до переразвертывания.
Сравнение двух развертываний
Нажмите Compare на развертывании, чтобы сравнить его с предыдущим: время сборки, размер артефакта, состояние кэша, фреймворк и сравнение артефакта на уровне файлов. Это самый быстрый способ узнать "что именно изменилось", когда развертывание ведет себя иначе, чем предыдущее.
Когда сборка не удается
Статус-карточка переходит в Failed и журнал показывает, где она остановилась. Выше журнала Orbit добавляет категоризованную сводку ошибок с предложенным исправлением. Распознанные категории включают нехватку памяти, ошибку компиляции, ошибку теста, ошибку linter, ошибку установки, сетевую ошибку и тайм-аут, и Orbit сопоставляет определенные шаблоны, такие как отсутствующий модуль, конфликт ERESOLVE peer-зависимости, код ошибки TypeScript, полный диск сборки, 404 пакета и устаревший файл блокировки.
Также имеется кнопка Get AI diagnosis, которая читает последние 120 строк журнала вместе с обнаруженным фреймворком и категорией ошибки и возвращает простое объяснение на естественном языке.
Диагностика AI помечена AI-generated, verify before acting не просто так. Она очень хорошо указывает вам на правильную строку журнала, но не является авторитетной в отношении вашей кодовой базы. Прочитайте строку журнала, на которую она ссылается, перед тем как что-то изменять.
Повторная попытка неудачной сборки
На странице сведений развертывания нажмите Retry build, чтобы переустановить тот же коммит без отправки нового. Это исправляет временные ошибки, такие как сетевая ошибка во время установки.
Если вы подозреваете устаревшую кэшированную зависимость, используйте More retry options, затем Retry with cleared cache, что удалит кэш сборки перед повторной попыткой.
Полное руководство по сбою за сбоем находится в разделе Устранение неполадок неудачных сборок.
Отмена работающей сборки
Нажмите Cancel во время выполнения сборки.
Отмена немедленно завершает машину сборки и не может быть отменена. Развертывание записывается как Cancelled, и ранее живое развертывание продолжает обслуживать трафик, поэтому отмена никогда не снимает ваш сайт с эфира. Обратите внимание, что отправка нового коммита в ту же ветку во время выполнения сборки автоматически отменяет выполняемую сборку, поэтому отмененное развертывание, за которым следует запущенное,, это нормально.
Загрузка артефакта
Каждое успешное развертывание сохраняет свой упакованный вывод. Нажмите Download на карточке Artifact, чтобы загрузить точный пакет, который был обслужен. Есть также браузер артефактов для проверки содержимого без загрузки всего.
Как долго хранятся артефакты, устанавливается в Settings, в разделе Artifact retention: количество успешных артефактов для хранения на окружение, от 10 до 500, по умолчанию 50. Старые артефакты удаляются ежедневно. Артефакт текущего развертывания, находящегося в сети, всегда сохраняется, независимо от параметра.
Удержание артефактов, это то, что делает откат возможным. Установка его слишком низко сокращает то, как далеко вы можете откатить плохое развертывание без перестройки. Если вы развертываетесь много раз в день, поднимите его, а не понижайте.