단일 RUN 문에서 여러 명령을 결합하여 이미지 크기 줄이기

이 예에서는 Node.js와 같은 소프트웨어를 컨테이너 이미지에 설치해야 합니다. Node.js용 기본 이미지를 사용하여 Node.js 애플리케이션을 빌드하십시오.

Node.js를 수동으로 설치하려면 다음 Dockerfile 예를 사용할 수 있습니다.

FROM ubuntu

RUN apt update
RUN apt upgrade -y
RUN apt install -y nodejs
RUN apt clean
RUN rm -rf /var/lib/apt/lists/\*

이 예에서는 여러 RUN 명령문을 사용하여 Node.js를 업데이트, 업그레이드, 설치하고 파일 캐시를 정리한 후 제거합니다. 이 일련의 명령문은 올바르지만, 여러 RUN 문을 사용하는 것이 이를 구현하는 가장 좋은 방법은 아닙니다. Dockerfile이 처리될 때 Dockerfile에 있는 각 명령문은 계층을 작성합니다. 각 계층에는 작성 또는 업데이트된 파일과 삭제된 항목에 대한 정보가 포함됩니다. 컨테이너 이미지는 모든 계층의 콜렉션입니다. 파일이 한 명령문에서 추가되고 두 번째 명령문에서 삭제된 경우, 결과 이미지는 첫 번째 명령문에 대한 계층에서는 해당 파일을 계속 포함하고 있으며 두 번째 계층에서는 삭제된 것으로 표시합니다.

디스크 공간을 절약하려면 단일 RUN 문을 지정하여 이 명령 세트에 대한 단일 계층을 작성하십시오.

FROM ubuntu

RUN apt update && apt upgrade -y && apt install -y nodejs && apt clean && rm -rf /var/lib/apt/lists/\*

한 개의 명령이 한 행에 표시되도록 읽기 가능한 Dockerfile을 유지하려면 코드에 행 바꾸기를 추가하십시오.

FROM ubuntu

RUN \
    apt update && \
    apt upgrade -y && \
    apt install -y nodejs && \
    apt clean && \
    rm -rf /var/lib/apt/lists/\*

이 유형의 명령문을 사용하면 컨테이너 이미지 크기를 약 174MB에서 약 147MB로 줄일 수 있습니다. 예 크기는 Ubuntu 기본 이미지와 다를 수 있으며 Node.js 패키지가 변경될 수 있음을 참고하십시오.

이 유형의 우수 사례는 패키지 설치뿐만 아니라 유사한 태스크에도 적용됩니다. 다음 예에서 소프트웨어 패키지(Node.js)의 다운로드 및 추출은 다음 예와 유사할 수 있습니다.

FROM ubuntu

RUN apt update
RUN apt upgrade -y
RUN apt install -y curl
RUN curl https://nodejs.org/dist/v16.14.2/node-v16.14.2-linux-x64.tar.gz -o /tmp/nodejs.tar.gz
RUN mkdir /opt/node
RUN tar -xzf /tmp/nodejs.tar.gz -C /opt/node --strip 1
RUN rm /tmp/nodejs.tar.gz
RUN apt remove -y curl
RUN apt clean
RUN rm -rf /var/lib/apt/lists/\*

rm 명령은 다운로드한 nodejs 패키지를 제거하지만, 여러 RUN 문이 다시 별도의 계층을 작성합니다. 또한 nodejs 패키지를 다운로드하기 위해 curl 패키지가 임시로 설치됩니다. curl 패키지 자체는 나중에 제거되지만, 내재적으로 설치된 종속 항목은 계속 남아 있습니다. 더 나은 Dockerfile은 다음 예와 유사합니다.

FROM ubuntu

RUN \
    apt update && \
    apt upgrade -y && \
    apt install -y curl && \
    curl https://nodejs.org/dist/v16.14.2/node-v16.14.2-linux-x64.tar.gz -o /tmp/nodejs.tar.gz && \
    mkdir /opt/node && \
    tar -xzf /tmp/nodejs.tar.gz -C /opt/node --strip 1 && \
    rm /tmp/nodejs.tar.gz && \
    apt remove -y curl && \
    apt auto-remove -y && \
    apt clean && \
    rm -rf /var/lib/apt/lists/\*

관련 명령이 단일 RUN 문에 결합되며 종속 항목을 제거하기 위해 apt auto-remove 명령이 추가됩니다. 이 예에서는 이미지 크기가 약 222MB에서 약 162MB로 줄어듭니다.

작은 기본 이미지 사용

이전 예에서는 Ubuntu를 기본 이미지로 사용합니다. 이 이미지에는 유용한 유틸리티가 많이 포함되어 있지만, 기본 이미지에 있는 유틸리티가 많을수록 이미지 크기가 더 커질 수 있습니다. 또한 더 많은 유틸리티를 포함시키면 보안 취약성이 발생할 가능성이 높아져 이미지를 다시 빌드해야 할 수 있습니다. 이러한 문제를 방지하려면 더 작은 기본 이미지를 사용하십시오. 예를 들면 다음과 같습니다.

• Alpine은 작은 크기의 공식 Docker 이미지입니다. Java 또는 Node.js와 같은 프로그래밍 환경의 경우 Alpine을 기반으로 하는 태그를 종종 찾을 수 있습니다.

• Google Container Tools의 Distroless 이미지에는 운영 체제 도구 가 전혀 포함되어 있지 않지만, Java 및 Node.js와 같은 다양한 언어에 필요한 런타임 환경이 있습니다.

program.js 파일에서 Node.js 프로그램을 실행하는 컨테이너 이미지를 빌드하여 이러한 기본 이미지를 비교하십시오. Ubuntu의 경우 Dockerfile은 다음 예와 유사합니다.

FROM ubuntu

RUN \
    apt update && \
    apt upgrade -y && \
    apt install -y nodejs && \
    apt clean && \
    rm -rf /var/lib/apt/lists/\*

COPY program.js /app/program.js

WORKDIR /app

ENTRYPOINT ["node", "program.js"]

Alpine의 경우 Node.js에서 직접 이미지를 가져옵니다.

FROM node:16-alpine

COPY program.js /app/program.js

WORKDIR /app

ENTRYPOINT ["node", "program.js"]

distroless의 경우 다음 예를 사용하십시오.

FROM gcr.io/distroless/nodejs:16

COPY program.js /app/program.js

WORKDIR /app

CMD ["program.js"]

Ubuntu 기반 이미지는 147MB지만, Alpine 기반 이미지는 90MB이고 distroless 기반 이미지는 94MB입니다.

소스 및 빌드 도구를 포함하지 않고 이미지 크기 줄이기

이전 Node.js 기반 예에서는 단일 소스 파일이 컨테이너 이미지에 추가되었습니다. 이 예에서는 컴파일이 필요하지 않으므로 단일 소스 파일을 사용할 수 있습니다. 그러나 컴파일이 필요한 경우 빌드에 필요한 도구만 사용하되, 결과 이미지에는 포함시키지 마십시오. 예를 들어, Maven을 예로 사용하는 Java 애플리케이션을 지정하십시오. 잘못 코딩된 Dockerfile은 다음 예와 유사합니다.

FROM maven:3-jdk-11-openj9

WORKDIR /app
COPY . /app

RUN mvn package

EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/target/java-application-1.0-SNAPSHOT-fat.jar"]

생성되는 컨테이너 이미지에는 Maven 빌드 도구뿐 아니라 Maven의 모든 소스 코드와 모든 중간 파일(예: 아티팩트 캐시, 나중에 JAR 파일로 패키징되는 클래스 파일)이 포함되어 있습니다. 또한 런타임 시 훨씬 더 작은 JRE(Java Runtime Environment)가 필요한 경우 JDK(Java Development Kit)도 포함됩니다. 결과적으로 이미지 크기는 466MB입니다.

이미지를 더 작게 만들려면 다단계 빌드라는 기능을 사용하십시오. Docker 빌드의 각 단계에는 자체 기본 이미지가 있으며 해당 단계에서 명령을 실행할 수 있습니다. 마지막으로, 이전 단계의 아티팩트를 복사하는 최종 이미지가 빌드됩니다. 소스 코드에서 컨테이너 이미지를 빌드하기 위한 일반적인 패턴은 다음 두 개의 단계를 거치는 것입니다.

1. 소스 코드를 런타임용 2진으로 컴파일하는 데 필요한 모든 도구가 포함된 기본 이미지를 사용하는 빌더 단계.
2. 2진을 실행하는 데 필요한 런타임 환경에서 기본 이미지를 사용하는 런타임 단계. 빌더 단계의 2진이 이 단계로 복사됩니다.

Maven 프로젝트의 경우 결과는 다음 예와 유사합니다.

FROM maven:3-jdk-11-openj9 AS builder

WORKDIR /app
COPY . /app

RUN mvn package

FROM adoptopenjdk:11-jre-openj9

WORKDIR /app
COPY --from=builder /app/target/java-application-1.0-SNAPSHOT-fat.jar /app/java-application.jar

EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/java-application.jar"]

이 예에서는 빌더 단계에서 Maven 기본 이미지를 사용하여 애플리케이션의 JAR 파일을 빌드합니다. 런타임 단계에서는 더 작은 JRE 기본 이미지를 사용합니다. COPY --from=STAGE_NAME 명령을 사용하여 JAR 파일이 빌더 단계에서 런타임 단계로 복사됩니다. 생성되는 이미지의 크기는 242MB로, 약 48% 절감됩니다.

이 패턴은 컴파일을 수행해야 하는 다른 프로그래밍 언어에도 사용할 수 있습니다.

• 빌드가 필요한 노드 애플리케이션(예: Angular 또는 React 빌드). 여기서 빌더와 런타임 기본 이미지는 동일할 수 있지만(두 노드 모두), 모든 빌드 시간 아티팩트와 소스를 런타임 이미지로 복사해야 하는 것은 아닙니다.
• 소스 코드를 런타임 환경 없이 실행되는 기본 실행 파일로 컴파일하는 모든 프로그래밍 언어(예: Go 또는 Rust)

기본 실행 파일을 생성하며 런타임 환경이 전혀 필요하지 않은 언어의 경우 런타임 단계에 다른 Docker 기능(스크래치)을 사용하십시오. 스크래치는 FROM 명령의 기반으로 사용될 수 있지만, 최종 컨테이너 이미지는 아닙니다. 대신 Docker 빌드에서 기본 이미지가 사용되지 않도록 합니다. 기본 이미지에서 운영 체제 파일 없이 결과 이미지가 단일 파일(빌더 단계에서 복사된 2진 파일)만큼 작을 수 있습니다. 프로그래밍 언어 및 코드에 따라, 2진 파일이 존재하는 일부 운영 체제 파일에 의존할 수 있으므로 컴파일러 옵션을 추가로 조정해야 할 수도 있습니다.

이미지를 깨끗하게 유지하기

Dockerfile을 처음 개발하고 작동 방식을 디버깅할 때 몇 가지 임시 도구를 설치하거나 최종 컨테이너 이미지에 필요하지 않은 다른 워크로드를 적용했을 수 있습니다. 이러한 임시 파일과 워크로드를 제거하면 이미지가 작고 깨끗하며 더 안전한 상태로 유지됩니다.