Docker Buildx를 사용하다 보면 하나의 Builder만 사용하는 것이 아니라 여러 개의 Builder를 생성하여 관리하는 경우가 많습니다.
예를 들어:
- 기본 Docker Builder
- 개발용 Builder
- 운영용 Builder
- CI/CD 전용 Builder
- 멀티 플랫폼 Builder
등 다양한 빌드 환경을 구성할 수 있습니다.
하지만 Builder가 많아지면 현재 어떤 Builder가 존재하는지, 어떤 Builder가 활성 상태인지 확인해야 합니다.
이때 사용하는 명령어가 바로 Docker Buildx Ls입니다.
Docker Buildx Ls는 현재 생성되어 있는 Builder 목록을 확인하는 명령어입니다.
Builder 이름, Driver, 현재 선택된 Builder, 지원 플랫폼 등을 한눈에 확인할 수 있어 Buildx 환경 관리의 기본 명령어로 사용됩니다.
이번 글에서는 Docker Buildx Ls의 개념부터 기본 사용법, 출력 결과 분석, Builder 관리 방법, 실무 활용 방법까지 자세히 알아보겠습니다.
Docker Buildx Ls란 무엇인가?
Docker Buildx Ls(List)는 현재 시스템에 등록된 Buildx Builder 목록을 표시하는 명령어입니다.
확인 가능한 정보:
- Builder 이름
- Driver 종류
- 현재 활성 Builder
- Node 정보
- 지원 플랫폼
여러 빌드 환경을 관리할 때 가장 먼저 사용하는 명령어입니다.
Docker Buildx Ls는 언제 사용하는가?
다음과 같은 상황에서 사용합니다.
- Builder 목록 확인
- 현재 활성 Builder 확인
- 멀티 플랫폼 지원 확인
- 빌드 환경 점검
- Builder 전환 전 확인
특히 Builder를 여러 개 운영하는 환경에서는 필수 명령어입니다.
Docker Buildx Ls 기본 사용법
기본 명령어:
docker buildx ls출력 예:
NAME/NODE DRIVER
default * docker
production docker-container
multi-platform docker-container현재 등록된 Builder 목록을 확인할 수 있습니다.
Docker Buildx Ls 출력 결과 이해하기
출력 항목은 다음과 같습니다.
NAME/NODE
Builder 이름과 Node 정보를 표시합니다.
예:
production해당 Builder 이름입니다.
별표(*)가 표시된 Builder는 현재 사용 중인 Builder입니다.
예:
default *현재 선택된 Builder입니다.
DRIVER
Builder가 사용하는 Driver를 표시합니다.
예:
docker-container대표적인 Driver:
- docker
- docker-container
- kubernetes
- remote
PLATFORM
지원 가능한 플랫폼 정보를 확인할 수 있습니다.
예:
linux/amd64
linux/arm64멀티 플랫폼 빌드 가능 여부를 확인할 수 있습니다.
현재 사용 중인 Builder 확인하기
현재 활성 Builder는 * 표시로 확인합니다.
예:
NAME
default *
production현재 빌드는 default Builder를 사용합니다.
Docker Buildx Ls와 Inspect 차이
두 명령어는 함께 사용하지만 목적이 다릅니다.
Docker Buildx Ls
확인:
- 전체 Builder 목록
- 활성 Builder
- Driver
명령:
docker buildx lsDocker Buildx Inspect
확인:
- 특정 Builder 상세 정보
- BuildKit 상태
- 플랫폼 정보
명령:
docker buildx inspect정리하면:
Ls = 전체 목록 확인
Inspect = 상세 정보 확인
입니다.
Docker Buildx Ls 실무 활용 예제
Builder 목록 확인
현재 환경 확인:
docker buildx ls결과:
default *
ci-builder
arm-builder사용 가능한 Builder를 확인할 수 있습니다.
멀티 플랫폼 Builder 확인
출력:
NAME
multi-builder
PLATFORMS
linux/amd64
linux/arm64ARM과 AMD64 빌드 가능 여부를 확인합니다.
Builder 전환 전 확인
다른 Builder로 변경하기 전에:
docker buildx ls사용할 Builder 이름을 확인합니다.
이후:
docker buildx use multi-builder변경합니다.
Linux 서버 문제 해결
CI/CD 서버에서 예상과 다른 Builder로 이미지가 빌드되는 문제가 발생했습니다.
빌드 실행:
docker buildx build -t app:v1 .하지만 원하는 멀티 플랫폼 빌드가 되지 않았습니다.
먼저 Builder 목록을 확인했습니다.
docker buildx ls결과:
NAME
default *
multi-builder확인 결과 현재 기본 Builder를 사용하고 있었습니다.
멀티 플랫폼 Builder로 변경했습니다.
docker buildx use multi-builder다시 확인:
docker buildx ls결과:
multi-builder *이후 정상적으로 멀티 플랫폼 빌드를 실행할 수 있었습니다.
Docker Buildx Ls는 잘못된 Builder 사용 문제를 확인하는 가장 빠른 방법입니다.
Docker Buildx Ls 사용 시 주의사항
첫 번째는 Ls는 Builder 목록만 보여주는 명령어입니다.
상세 상태 확인은 Inspect를 사용해야 합니다.
두 번째는 현재 활성 Builder를 반드시 확인해야 합니다.
세 번째는 Builder가 많아질수록 이름 규칙을 정하는 것이 중요합니다.
네 번째는 운영 환경에서는 Builder 역할별 분리가 좋습니다.
Best Practice
Docker Buildx Ls를 사용할 때는 다음 방법을 추천합니다.
- 빌드 전 현재 Builder를 확인합니다.
- Builder 이름을 명확하게 관리합니다.
- 환경별 Builder를 분리합니다.
- 멀티 플랫폼 Builder를 별도로 운영합니다.
- Inspect와 함께 사용합니다.
- 불필요한 Builder는 정리합니다.
자주 묻는 질문
Docker Buildx Ls는 무엇인가요?
현재 등록된 Docker Buildx Builder 목록을 확인하는 명령어입니다.
별표(*)는 무엇인가요?
현재 선택되어 사용 중인 Builder를 의미합니다.
Builder를 생성하면 Ls에서 확인되나요?
네.
생성된 모든 Builder는 목록에 표시됩니다.
Ls와 Inspect 중 어떤 것을 먼저 사용해야 하나요?
일반적으로 Ls로 목록 확인 후 Inspect로 상세 정보를 확인합니다.
마무리
Docker Buildx Ls는 Buildx Builder 환경을 관리하기 위한 가장 기본적인 명령어입니다.
현재 생성된 Builder 목록, 활성 Builder, Driver, 플랫폼 정보를 빠르게 확인할 수 있어 Docker 빌드 환경 점검에 필수적으로 사용됩니다.
특히 여러 Builder를 운영하는 CI/CD 환경이나 멀티 플랫폼 빌드 환경에서는 docker buildx ls를 통해 현재 사용 중인 Builder를 확인하는 습관이 중요합니다.