ENTRYPOINT와 CMD는 모두 container가 시작될 때 실행되는 것을 정의하지만, 서로 다른 역할을 하며 특정 방식으로 상호작용합니다. 그 차이(와 두 가지 형식 — exec 대 shell)를 이해하는 것은 올바르게 동작하는 Dockerfile을 작성하는 데 중요합니다.
CMD ["node", "server.js"]
# → container가 시작될 때의 기본 명령
# → 그러나 실행 시 명령을 전달하면 대체됨:
# docker run myapp echo hello → node server.js 대신 "echo hello" 실행
는 을 제공하며, 에 주어진 모든 명령으로 됩니다.
CMDdocker runENTRYPOINT ["node", "server.js"]
# → 항상 실행됨; 실행 시 인자는 추가됨(대체하지 않음):
# docker run myapp --port 8080 → "node server.js --port 8080" 실행
# → container가 특정 실행 파일처럼 동작하게 만듦
ENTRYPOINT는 항상 실행되는 고정된 실행 파일을 설정합니다; 실행 시 인자는 대체하는 것이 아니라 그 인자로 추가됩니다.
ENTRYPOINT ["node", "server.js"] # 고정된 명령
CMD ["--port", "3000"] # 기본 인자(재정의 가능)
# docker run myapp → node server.js --port 3000 (기본값)
# docker run myapp --port 8080 → node server.js --port 8080 (CMD 재정의됨)
→ ENTRYPOINT = 명령; CMD = 재정의할 수 있는 기본 인자. 깔끔한 패턴.
EXEC 형식 → CMD ["node", "server.js"] (JSON 배열) — 선호됨:
실행 파일을 직접 실행(PID 1) → 신호(SIGTERM)를 받음 → 우아한 종료
SHELL 형식 → CMD node server.js → /bin/sh -c를 통해 실행 → 셸이 PID 1,
앱이 신호를 제대로 받지 못할 수 있음(종료 문제) → 메인 프로세스에는 피할 것
ENTRYPOINT와 CMD의 차이를 이해하는 것은 올바르게 동작하는 Dockerfile을 작성하는 데 중요하므로, 가치 있는 실용 지식이자 흔히 혼동되는 주제입니다.
동작의 구분이 중요합니다. CMD는 docker run에 전달된 모든 명령으로 완전히 재정의되는 기본 명령을 제공하는 반면, ENTRYPOINT는 실행 시 인자가 그것에 추가되어 항상 실행되는 고정된 실행 파일을 설정합니다 — container가 실행 시 인자에 어떻게 반응하는지에 영향을 미치는 다른 동작입니다.
그것들을 함께 사용하는 흔한 패턴(ENTRYPOINT를 명령으로, CMD를 재정의 가능한 기본 인자로)을 이해하는 것은 container를 구성 가능한 실행 파일처럼 동작하게 만드는 깔끔하고 관용적인 접근법입니다 — 알아둘 가치가 있는 널리 사용되는 기법입니다.
결정적으로, exec 형식 대 shell 형식을 이해하는 것은 정확성에 중요합니다. exec 형식(JSON 배열, 예: CMD ["node", "server.js"])이 선호됩니다. 그것이 실행 파일을 PID 1로 직접 실행하여 SIGTERM 같은 신호를 제대로 받아 우아한 종료를 가능하게 하기 때문입니다 — 반면 shell 형식(CMD node server.js)은 PID 1이 되는 셸을 통해 실행되어, 종종 애플리케이션이 종료 신호를 올바르게 받지 못하게 합니다(우아하지 않은 종료, 진행 중인 작업 손실, 느린 멈춤으로 이어짐).
이 신호 처리/우아한 종료 문제는 exec 형식이 피하는 실제적이고 미묘한 문제입니다.
container가 시작될 때 실행되는 것을 정의하는 것은 모든 Dockerfile에 근본적이고, ENTRYPOINT/CMD 구분(과 exec 대 shell 형식 신호 처리 관심사)이 container 동작과 정확성(인자 처리, 우아한 종료)에 직접 영향을 미치므로, ENTRYPOINT 대 CMD — 그것들의 역할, 결합 방식, 중요한 신호를 위한 exec 형식 관행 — 를 이해하는 것은 가치 있고 실질적으로 관련된 Docker 지식이며, 차이를 이해하는 것이 실제 동작 및 종료 버그를 방지하는 흔히 오해되는 주제입니다.