docker build

docker build (이미지 빌드)

Docker 빌드 명령 docker build에 대한 레퍼런스예요. Dockerfile과 빌드 컨텍스트에서 컨테이너 이미지를 빌드하는 명령입니다.

출처: 문서

본문

docker build는 Dockerfile과 빌드 컨텍스트를 이용해 이미지를 만듭니다. 기본적으로 현재 디렉터리를 컨텍스트로 사용하고, Dockerfile에서 지시어를 순서대로 실행해 레이어를 쌓아 이미지를 생성해요.

기본 문법

docker build [OPTIONS] PATH | URL | -

주요 옵션은 다음과 같아요.

  • -t, --tag: 빌드한 이미지에 붙일 이름과 태그. 여러 번 지정할 수 있고 -f로 Dockerfile 위치를, --target으로 멀티 스테이지 빌드의 특정 스테이지까지만 빌드할 수 있습니다.
  • --build-arg: 빌드 시 Dockerfile에서 사용할 빌드 인자를 설정해요.
  • -f, --file: 사용할 Dockerfile 경로.
  • --platform: 빌드 대상 플랫폼을 지정해요.
  • --secret: 빌드 중 사용할 시크릿을 전달해요.
  • --ssh: 빌드 중 SSH 에이전트 접근을 허용해요.
  • --progress: 진행 출력 형식(auto/plain/tty)을 설정해요.
  • --check: 빌드 전에 Dockerfile을 검사(빌드 체크)해요.

빌드는 BuildKit을 기본 백엔드로 사용하며, docker buildx build가 더 확장된 빌드 기능을 제공합니다.

더 알아보기