ARG와 ENV 차이

기본 패턴

ARG NODE_VERSION=22
FROM node:${NODE_VERSION}-alpine

ENV NODE_ENV=production
ENV PORT=3000

설명

• ARG는 이미지 빌드 과정에서만 쓰는 변수입니다. 베이스 이미지 버전, 빌드 옵션, 의존성 경로 같은 값을 빌드 시점에 바꿀 때 적합합니다.
• ENV는 최종 이미지와 컨테이너 실행 환경에 남는 변수입니다. 애플리케이션 설정 기본값, 런타임 옵션, 포트 같은 값에 주로 씁니다.
• 둘 다 "변수"처럼 보이지만 생존 범위가 다릅니다. ARG는 빌드가 끝나면 런타임 기본값으로 직접 쓰이지 않습니다.
• 실전에서는 "이미지를 어떻게 만들 것인가"와 "컨테이너가 어떤 설정으로 돌 것인가"를 이 둘로 분리해서 생각하면 Dockerfile 구조가 훨씬 선명해집니다.
• 민감한 값은 ARG든 ENV든 Dockerfile에 직접 적는 방식이 적절하지 않을 수 있습니다. Secret 관리 도구를 따로 봐야 하는 경우가 많습니다.

짧은 예제

docker build --build-arg NODE_VERSION=20 -t my-app .
docker run -e PORT=4000 my-app

빠른 정리

주의할 점