4.3. 빌드 이력 확인
어떨 때 보는가
- 빌드가 성공했는지 확인할 때
- 빌드가 실패한 이유를 찾을 때
- 어떤 이미지가 언제 만들어졌는지 거슬러 볼 때
빌드는 파드로 돈다
빌드는 별도 서버가 아니라 클러스터 안에서 파드로 실행됩니다.
이 점을 알아 두면 문제 원인을 짐작하기 쉽습니다.
| 겪는 문제 | 파드와 같은 원인 |
|---|---|
| 빌드가 시작되지 않음 | 노드에 자원이 없거나 네임스페이스 한도에 걸림 (8.1 장) |
| 빌드가 중간에 죽음 | 메모리 상한 초과 (OOMKilled) |
| 이미지를 못 가져옴 | 빌더 이미지 pull 실패 |
| 오래 걸림 | 노드가 바쁘거나 캐시가 없음 |
빌드 파드는 끝나면 정리되지만, 결과와 로그는 빌드 자원에 남습니다.
빌드 목록
빌드 > 빌드 이력 로 들어가면 지금까지 실행한 빌드가 나옵니다.

| 열 | 설명 |
|---|---|
| 이름 | build-<빌드 설정 이름>-<시각>-<임의 4자> |
| 네임스페이스 | 속한 네임스페이스 |
| 상태 | 빌드 진행 상태 |
| 빌드 설정 | 이 빌드를 실행한 빌드 설정. 누르면 그 빌드 설정 상세로 이동합니다 |
| 출력 이미지 | 이 빌드가 레지스트리에 올린 이미지와 태그 |
| 시작 시간 | 빌드를 시작한 시각 |
| 경과 시간 | 빌드를 만든 뒤 지난 시간 |
이름 앞에는 항상 build- 가 붙습니다. 빌드는 네임스페이스 안에서 Job 으로 실행되는데,
접두어가 없으면 다른 Job 사이에 섞여 어느 것이 빌드 이력인지 구분되지 않기 때문입니다.
예: build-egov-build-20260827143012-a3f9.
출력 이미지 열에서는 태그를 굵게 보여 줍니다. 앞의 레지스트리 주소와 이미지 이름은 흐리게 나오고, 칸보다
길면 뒤를 줄여 보여 줍니다. 마우스를 올리면 전체 주소가 보입니다. 여러 빌드가 각각 어떤 태그를 만들었는지 상세에
들어가지 않고 비교할 수 있습니다. 아직 이미지를 올리지 않은 빌드와, 빌드 Pod 가 정리된 GitRef 빌드는 이 칸이 비어 있습니다.
빌드가 평소보다 오래 걸리면 의존 라이브러리를 새로 받고 있거나 빌드 자원이 모자란 경우가 많습니다. 캐시 볼륨을 붙이면 줄어듭니다(4.2 장).
빌드 상태
| 상태 | 뜻 | 다음에 할 일 |
|---|---|---|
| Pending | 시작을 기다리는 중 | 오래 머물면 자원 한도를 확인합니다 |
| Running | 빌드 진행 중 | 로그를 실시간으로 볼 수 있습니다 |
| Complete | 성공. 이미지가 레지스트리에 올라갔습니다 | 배포합니다 |
| Failed | 실패 | 로그에서 원인을 확인합니다 |
| Cancelled | 사용자가 취소했습니다 |
진행 중인 빌드는 상태 뱃지에 회전 표시가 붙습니다(1.2 장).
빌드 상세
빌드 이름을 누르면 상세 화면이 열립니다.

| 구역 | 무엇을 알 수 있는가 |
|---|---|
| 메타데이터 | 이름·네임스페이스·생성 시각, 상태, 어느 빌드 설정 에서 나온 빌드인지, 출력 이미지 의 전체 주소와 태그 |
| 빌드 Pod | 빌드를 실행한 Pod 의 이름·상태·노드·Pod IP·시작 시간 |
| 컨테이너 | 빌드 Pod 의 초기화 컨테이너와 컨테이너의 상태, 종료 코드, 시작·완료 시각 |
| 이벤트 | 빌드 Pod 와 Job 의 이벤트(스케줄 실패, 이미지 받기 실패 등) |
제목 오른쪽 버튼으로 로그 보기, 이 빌드 배포, 편집, 삭제, 새로고침을 할 수 있습니다.
출력 이미지의 태그 를 확인하면 이 이미지가 어느 시점의 코드로 만들어졌는지 알 수 있습니다.
태그 방식이 GitRef 이면 태그가 <브랜치>-<커밋 해시> 입니다(예: master-548c100, 4.2 장).
"배포했는데 수정한 내용이 없다" 는 경우 이 값을 먼저 보십시오. 브랜치는 맞는데 커밋 해시가 옛
것이면 소스가 저장소에 올라가지 않은 것입니다.
빌드 로그 읽는 법
로그는 단계별로 이어집니다. 실패한 단계를 먼저 찾으면 원인이 좁혀집니다.
| 순서 |
|---|