빌드 로그 보기

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에서 프로젝트를 엽니다.
Deployments 탭을 엽니다.
배포를 클릭하여 상세 페이지를 엽니다.
전체 빌드 로그가 해당 페이지에 있습니다.

Overview 탭의 Recent deployments 목록의 각 행에는 같은 페이지로 가는 View logs 링크가 있습니다. 미리보기 배포도 Preview deployments 섹션에 같은 링크가 있습니다.

빌드 단계

상세 페이지는 빌드를 각각의 기간이 지정된 명명된 단계로 나눕니다:

단계	수행되는 작업
Clone	배포된 커밋에서 저장소 가져오기
Cache restore	캐시된 `node_modules` 압축 해제, 빌드 캐시가 있는 플랜에서
Install	설치 명령어 실행
Cache save	다음 빌드를 위해 `node_modules` 다시 압축
Build	빌드 명령어 실행
Upload	출력 디렉터리 패키징 및 아티팩트 저장
Done	아티팩트가 트래픽 앞에 배치됨

이것이 "왜 해당 빌드가 느렸나"에 대답하는 가장 빠른 방법입니다. Cold build 배지가 있는 긴 Install 단계는 캐시가 미스되었다는 뜻입니다. 긴 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은 로그를 분석하고 중요한 사항을 표시합니다.

단계별 기간이 있는 빌드 타임라인.
빌드가 자신의 중앙값보다 현저히 느릴 때 느린 빌드 감지, 백분율 및 지난 10개 빌드의 일반적인 시간 포함.
빌드가 타입 확인에서 실패했을 때 추출되고 계산된 TypeScript 오류.
Next.js 빌드의 빌드 분석: 경로당 크기, 첫 로드 JS, 정적, 동적 및 ISR 경로 수.
경로의 첫 로드 JS가 이전 배포 대비 20% 이상 증가하거나 공유 JS 번들이 증가할 때 번들 회귀 경고.
설치 출력에서 직접 분석된 npm audit 결과, 심각도별로 요약.
60점 만점의 보안 헤더 감시.
연기 테스트 경로를 구성한 경우 연기 테스트 결과.
예산을 설정한 경우 초과된 성능 예산.
구체적인 변경 사항과 예상 크기 절약을 나열하는 빌드 최적화 조언, 영향별로 순위 지정.
해당 배포가 라이브인 동안 기록된 p75 Core Web Vitals인 실제 사용자 메트릭.

빌드가 실제로 본 환경 변수

상세 페이지는 빌드 시 주입된 환경 변수 키를 나열하고 현재 구성과 비교합니다: 추가됨, 변경됨, 제거됨, 변경 없음. 청록색 키는 환경 특정 재정의에서 온 것이고 회색은 프로젝트 수준에서 온 것입니다.

값은 절대 저장되지 않으며 절대 표시되지 않습니다. 키에 마우스를 올리면 SHA-256 지문이 표시되어 값을 공개하지 않고 두 환경이 같은 값을 가지고 있는지 확인할 수 있습니다.

이 diff는 "환경 변수 변경 사항이 실제로 빌드로 들어갔는가"에 답하는 가장 빠른 방법입니다. 배포가 변경보다 먼저 만들어진 경우 Orbit은 Environment variables updated since this deployment 알림과 함께 표시하고 변경 사항이 재배포될 때까지 적용되지 않음을 상기시킵니다.

두 배포 비교

배포의 Compare를 클릭하여 이전 배포와 비교: 빌드 시간, 아티팩트 크기, 캐시 상태, 프레임워크, 파일 수준 아티팩트 diff. 배포가 이전 배포와 다르게 동작할 때 "실제로 무엇이 변경되었는가"를 빨리 알아보는 방법입니다.

빌드 실패 시

상태 카드가 Failed로 바뀌고 로그는 중지된 위치를 보여줍니다. 로그 위에 Orbit은 분류된 실패 요약과 제안된 수정을 추가합니다. 인식된 범주에는 메모리 부족, 컴파일 오류, 테스트 실패, 린트 오류, 설치 오류, 네트워크 오류 및 타임아웃이 포함되며, Orbit은 누락된 모듈, ERESOLVE 피어 의존성 충돌, TypeScript 오류 코드, 전체 빌드 디스크, 패키지 404 및 오래된 잠금 파일과 같은 특정 패턴을 매칭합니다.

또한 Get AI diagnosis 버튼이 있으며, 이는 로그의 마지막 120줄과 감지된 프레임워크 및 실패 범주를 읽고 평문 설명을 반환합니다.

AI 진단이 AI-generated, verify before acting으로 레이블이 지정된 이유가 있습니다. 로그의 올바른 라인을 가리키는 데 매우 능숙하지만 코드베이스에 대해 권위 있지 않습니다. 뭔가 변경하기 전에 참조하는 로그 라인을 읽으세요.

실패한 빌드 재시도

배포 상세 페이지에서 Retry build를 클릭하여 새 커밋을 푸시하지 않고 같은 커밋을 다시 실행합니다. 이것은 설치 중 네트워크 오류 같은 일시적 실패를 수정합니다.

오래된 캐시된 의존성을 의심하면 More retry options를 사용한 다음 Retry with cleared cache를 사용하여 재시도 전에 빌드 캐시를 삭제합니다.

전체 실패별 지침은 실패한 빌드 문제 해결에 있습니다.

실행 중인 빌드 취소

빌드가 실행 중일 때 Cancel을 클릭합니다.

취소하면 빌드 머신이 즉시 종료되며 실행 취소할 수 없습니다. 배포는 Cancelled로 기록되고 이전에 라이브인 배포는 트래픽을 계속 제공하므로 취소는 사이트를 다운시키지 않습니다. 빌드가 실행 중일 때 같은 브랜치로 새 커밋을 푸시하면 진행 중인 빌드를 자동으로 취소하므로 취소된 배포 다음에 실행 중인 배포가 있는 것은 정상입니다.

아티팩트 다운로드

모든 성공적인 배포는 패키징된 출력을 유지합니다. Artifact 카드의 Download를 클릭하여 제공된 정확한 번들을 가져옵니다. 전체 번들을 다운로드하지 않고 내용을 검사하기 위한 아티팩트 브라우저도 있습니다.

아티팩트가 보관되는 기간은 Settings의 Artifact retention 아래에서 설정됩니다: 환경당 유지할 성공적인 아티팩트 수(10~500), 기본값 50. 오래된 아티팩트는 매일 삭제됩니다. 현재 라이브인 배포의 아티팩트는 설정에 관계없이 항상 유지됩니다.

아티팩트 보유 기간은 롤백을 가능하게 하는 것입니다. 너무 낮게 설정하면 재빌드 없이 나쁜 배포를 롤백할 수 있는 기간을 단축합니다. 하루에 여러 번 배포하면 낮추는 것보다 높이세요.