Docker Buildx를 사용하다 보면 여러 개의 Builder를 생성하고 관리하게 됩니다.
예를 들어:
- 기본 Docker Builder
- CI/CD 전용 Builder
- 멀티 플랫폼 Builder
- 테스트용 Builder
등 다양한 빌드 환경을 구성할 수 있습니다.
하지만 Builder가 많아지면 현재 어떤 Builder를 사용하고 있는지, 정상적으로 실행되고 있는지 확인해야 합니다.
이때 사용하는 명령어가 바로 Docker Buildx Inspect입니다.
Docker Buildx Inspect는 현재 사용 중인 Builder 또는 특정 Builder의 상세 정보를 확인하는 명령어입니다.
Builder 이름, Driver, Node 상태, 지원 플랫폼, BuildKit 정보 등을 확인할 수 있어 Docker 빌드 환경 관리에서 매우 중요한 기능입니다.
이번 글에서는 Docker Buildx Inspect의 개념부터 기본 사용법, 출력 정보 확인 방법, Builder 상태 점검, 실무 활용 방법까지 자세히 알아보겠습니다.
Docker Buildx Inspect란 무엇인가?
Docker Buildx Inspect는 Buildx Builder의 상세 정보를 확인하는 명령어입니다.
docker buildx ls가 Builder 목록을 보여주는 명령이라면,
docker buildx inspect는 특정 Builder 내부 정보를 자세히 확인하는 명령입니다.
확인 가능한 정보:
- Builder 이름
- Driver 종류
- BuildKit 상태
- Node 정보
- 지원 플랫폼
- 연결된 Docker 환경
Docker Buildx Inspect는 언제 사용하는가?
다음과 같은 상황에서 사용합니다.
- Builder 상태 확인
- 빌드 오류 분석
- 멀티 플랫폼 지원 확인
- CI/CD 환경 점검
- BuildKit 연결 문제 해결
특히 여러 Builder를 운영하는 환경에서는 필수적인 관리 명령어입니다.
Docker Buildx Inspect 기본 사용법
현재 활성 Builder 확인:
docker buildx inspect출력 예:
Name:
default
Driver:
docker-container
Nodes:
builder0현재 선택된 Builder 정보를 확인할 수 있습니다.
특정 Builder 정보 확인하기
Builder 이름을 지정할 수 있습니다.
기본 형식:
docker buildx inspect [Builder 이름]예:
docker buildx inspect production-builder해당 Builder의 상세 정보를 출력합니다.
Docker Buildx Inspect 출력 결과 이해하기
예:
Name:
production-builder
Driver:
docker-container
Status:
running각 항목을 확인할 수 있습니다.
Name
Builder 이름입니다.
예:
production-builder현재 확인 중인 Builder를 의미합니다.
Driver
Builder가 사용하는 실행 방식을 표시합니다.
예:
docker-container대표적인 Driver:
- docker
- docker-container
- kubernetes
- remote
Nodes
Builder를 구성하는 Node 정보를 보여줍니다.
예:
Nodes:
builder0멀티 노드 빌드 환경에서 사용됩니다.
Platforms
지원 가능한 플랫폼을 확인할 수 있습니다.
예:
Platforms:
linux/amd64
linux/arm64멀티 플랫폼 빌드 가능 여부를 확인할 수 있습니다.
Docker Buildx Inspect –bootstrap 사용법
BuildKit 실행 상태까지 확인하려면:
docker buildx inspect --bootstrap사용합니다.
--bootstrap 옵션은 Builder를 초기화하고 BuildKit 컨테이너를 실행합니다.
출력:
Status:
runningBuilder 상태를 확인할 수 있습니다.
Docker Buildx Inspect와 LS 차이
두 명령어는 역할이 다릅니다.
Docker Buildx LS
확인:
- Builder 목록
- 현재 선택 Builder
명령:
docker buildx lsDocker Buildx Inspect
확인:
- Builder 상세 정보
- Node 상태
- 플랫폼 정보
명령:
docker buildx inspect정리하면:
LS = 목록 확인
Inspect = 상세 분석
입니다.
Docker Buildx Inspect 실무 활용 예제
멀티 플랫폼 빌드 전 확인
빌드 전 Builder 상태 확인:
docker buildx inspect출력:
Platforms:
linux/amd64
linux/arm64멀티 플랫폼 빌드가 가능한 환경인지 확인합니다.
CI/CD Builder 점검
배포 서버에서:
docker buildx inspect ci-builder확인:
- Builder 실행 여부
- BuildKit 상태
- 지원 플랫폼
자동 빌드 오류를 예방할 수 있습니다.
Linux 서버 문제 해결
CI/CD 서버에서 Docker 빌드가 실패했습니다.
오류:
failed to connect to builder먼저 Builder 상태를 확인했습니다.
docker buildx inspect production-builder결과:
Status:
inactiveBuildKit 실행 상태 문제가 원인이었습니다.
Builder를 다시 초기화했습니다.
docker buildx inspect production-builder --bootstrap결과:
Status:
running이후 다시 빌드를 실행했습니다.
docker buildx build -t app:v1 .정상적으로 이미지 빌드가 완료되었습니다.
Docker Buildx Inspect는 Builder 문제를 확인하는 가장 기본적인 점검 명령어입니다.
Docker Buildx Inspect 사용 시 주의사항
첫 번째는 Inspect는 정보 확인 명령어입니다.
이미지를 생성하거나 변경하지 않습니다.
두 번째는 Builder 이름을 정확하게 입력해야 합니다.
세 번째는 멀티 플랫폼 빌드 전 지원 플랫폼을 확인하는 것이 좋습니다.
네 번째는 문제가 발생하면 --bootstrap 옵션으로 BuildKit 상태를 확인할 수 있습니다.
Best Practice
Docker Buildx Inspect를 사용할 때는 다음 방법을 추천합니다.
- 빌드 전 Builder 상태를 확인합니다.
- 멀티 플랫폼 지원 여부를 확인합니다.
- CI/CD 환경 점검에 활용합니다.
- 오류 발생 시 BuildKit 상태를 확인합니다.
- 중요한 Builder 정보는 기록합니다.
- LS와 함께 사용합니다.
자주 묻는 질문
Docker Buildx Inspect는 무엇인가요?
Docker Buildx Builder의 상세 정보를 확인하는 명령어입니다.
LS와 Inspect 차이는 무엇인가요?
LS는 목록 확인, Inspect는 상세 정보 확인입니다.
Inspect가 이미지를 확인하나요?
아닙니다.
Builder 환경을 확인합니다.
–bootstrap 옵션은 무엇인가요?
Builder를 초기화하고 BuildKit 실행 상태를 확인하는 옵션입니다.
마무리
Docker Buildx Inspect는 Docker 빌드 환경을 관리하기 위해 반드시 알아야 하는 기본 명령어입니다.
Builder 이름, Driver, BuildKit 상태, 지원 플랫폼 등을 확인할 수 있어 빌드 오류 분석과 환경 점검에 매우 유용합니다.
특히 멀티 플랫폼 빌드와 CI/CD 환경에서는 docker buildx ls와 docker buildx inspect를 함께 사용하면 안정적인 Docker 빌드 환경을 유지할 수 있습니다.