도커파일 편집하기

도커파일(Dockerfile)은 도커 이미지(Docker image)를 자동으로 빌드하기 위해 필요한 명령들을 순서대로 나열한 텍스트 파일이다.
==정의==
도커파일은 도커 엔진이 이미지 생성 시 실행할 모든 명령을 담고 있는 텍스트 문서이며, 명령어 하나하나가 이미지의 레이어(layer)를 구성한다.
==주요 지시어(Instructions)==
도커파일에는 다음과 같은 지시어들이 가장 일반적으로 사용된다:
*'''FROM''' – 빌드의 기반이 되는 베이스 이미지를 지정한다. 도커파일은 반드시 이 지시어로 시작해야 한다.
*'''RUN''' – 이미지 빌드 과정 중에 쉘 명령을 실행하여 설치 및 구성 작업을 수행한다.
*'''COPY''' / '''ADD''' – 호스트의 파일 또는 디렉토리를 이미지 내부로 복사한다. ADD는 URL 및 압축 파일 자동 풀기 기능도 지원한다.
*'''WORKDIR''' – 이후 지시어들(RUN, CMD 등)이 실행될 작업 디렉토리를 설정한다.
*'''ENV''' – 환경 변수 설정.
*'''EXPOSE''' – 컨테이너가 사용하는 네트워크 포트를 명시.
*'''ENTRYPOINT''' / '''CMD''' – 컨테이너 시작 시 실행될 기본 명령을 지정한다. ENTRYPOINT는 고정 실행이 가능하며, CMD는 기본 실행 명령으로서 덮어쓰기 가능하다.
*이 외에도 '''LABEL''', '''USER''', '''VOLUME''', '''HEALTHCHECK''', '''ARG''', '''ONBUILD''' 등 다양한 지시어들이 존재한다.
==쓰기 방식 및 형식==
도커파일은 대문자 지시어와 인수를 활용한 다음 형식으로 작성한다:<syntaxhighlight lang="dockerfile">
# 주석
INSTRUCTION arguments
</syntaxhighlight>주석은 `#`로 시작하며, 파서는 이를 무시한다.
==예제==
간단한 Python 애플리케이션용 예시 도커파일:<syntaxhighlight lang="dockerfile">
FROM python:3.13
WORKDIR /usr/src/app
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY src/ ./src
EXPOSE 5000
CMD ["python", "src/main.py"]
</syntaxhighlight>이 도커파일은 베이스 이미지 지정, 작업 디렉토리 설정, 의존성 설치, 코드 복사, 포트 노출, 실행 명령 지정 등의 일반적인 흐름을 보여준다.
==작성 시 권장 모범 사례==
*필요한 지시어를 하나의 RUN으로 결합해 레이어 수를 최소화한다.
*빌드 단계를 최적화하고, 불필요한 파일은 제거하여 이미지 크기를 줄인다.
*유지보수성과 효율성을 고려해 Dockerfile 리팩터링을 정기적으로 수행한다. 예컨대 자동화된 리팩토링 도구를 활용하면 이미지 크기와 빌드 시간을 유의미하게 줄일 수 있다.
*지시어 순서를 재구성해 CI/CD 환경에서 반복 빌드시 효율을 높이는 전략도 가능하다.
==같이 보기==
*[[Docker (소프트웨어)]]
*[[컨테이너 이미지]]
*[[CI/CD]]
*[[인프라 코드]]
*[[컨테이너 레지스트리]]
==참고 문헌==
*Docker Docs, “Dockerfile reference”
*Docker Docs, “Writing a Dockerfile”
*Medium, “A Dockerfile is the basic concept for building Docker images”
*Sealos Blog, “What Is a Dockerfile? Complete Guide to Docker Image Creation”
*arXiv, “Refactoring for Dockerfile Quality: A Dive into Developer Practices and Automation Potential”
*arXiv, “Doctor: Optimizing Container Rebuild Efficiency by Instruction Re‑Orchestration”
==각주==
[[분류:가상화]]