Docker 이미지 사이즈 줄이기

<aside> ✏️

</aside>

줄이기 전

참고: docker 코드 해석과 수동 배포 방식

현재 BooLock 프로젝트 docker 이미지 사이즈이다.
base 이미지는 pnpm 패키지 매니저를 사용하고 있기에, pnpm 패키지 매니저를 설치하고, 프론트엔드와 백엔드가 공통적/개별적으로 사용하는 라이브러리들을 pnpm 캐시에 저장해주어 base 이미지를 사용하는 이미지들이 라이브러리 설치를 캐시에 저장되어있는 정보를 가지고 오프라인으로 빠르게 설치할 수 있게 도와주는 역할을 하기에 이미지 크기가 크다.
frontend는 base 이미지에 있는 정보들을 그대로 가져온 채 배포 된 것이 아니라, 멀티 스테이지 빌드로 배포 파일을 만드는 역할을 하는 빌드 스테이지와 배포 스테이지를 분리하여 최종적으로 배포하는 스테이지 이미지의 사이즈를 대폭 줄일 수 있었다.
- 그래서 배포된 이미지 크기가 59.4MB이다.
반면에, backend는 base 이미지에 있는 파일들을 그대로 가져오고, 라이브러리들이 깔려있는 상태 그대로 배포가 된 상태라 사이즈가 631MB로 큰 편이다.
- 물론 백엔드는 프론트엔드처럼 정적파일을 만들어 배포할 수 없고, 동작하기 위해선 라이브러리가 필요하기에 사이즈가 큰 것은 어쩔 수 없다.
- 허나 비교적 종속성이 복잡하지 않고 단순한 서버 라이브러리인 node.js+express로 개발하였고, 백엔드 규모 자체도 크지 않은 프로젝트이기에 적정 사이즈는 200~400MB 사이라고 생각하였기에 줄일 필요가 있다고 생각했다.
- 도커 사이즈를 줄일 수 있는 방법을 알아보고 백엔드 사이즈를 400MB대로 줄이는 것을 목표로 한다.

Docker 이미지 사이즈 줄이는 방법

멀티 스테이지 빌드

https://docs.docker.com/build/building/multi-stage/

멀티 스테이지 빌드는 Dockerfile 내에서 레이어들을 여러 단계(이미지)로 분리하여, 최종 이미지를 실행할 때 필요한 중간 과정들을 최종 단계(이미지)에서는 포함시키지 않아 실제 실행되는 최종 이미지의 사이즈를 간소화할 수 있다.
멀티 스테이지 빌드는 프론트엔드 이미지를 만들 때 사용한 방법이다.

FROM base-image AS frontend-build
WORKDIR /app/apps/client
COPY ./apps/client .
COPY --from=base-image /app/packages /app/packages
RUN pnpm install --offline --frozen-lockfile
RUN pnpm run build

FROM nginx:alpine AS frontend
COPY --from=frontend-build /app/apps/client/dist /usr/share/nginx/html
COPY /apps/client/nginx.conf /etc/nginx/conf.d/default.conf
COPY /apps/client/ssl /etc/nginx/ssl

RUN chmod -R 755 /usr/share/nginx/html
RUN chmod 644 /etc/nginx/ssl/fullchain.pem
RUN chmod 600 /etc/nginx/ssl/privkey.pem
RUN chown -R nginx:nginx /usr/share/nginx/html /etc/nginx/ssl

EXPOSE 80 443
CMD ["nginx", "-g", "daemon off;"]

프론트엔드 Dockerfile을 보면 frontend-build 이미지에서는 종속성도 설치하고, 빌드파일도 만든다. ⇒ 종속성으로 인해 이미지 크기가 크다.
하지만 이후 단계인 frontend 이미지에서 frontend-build에서 만든 빌드파일만 가져오고, 이외의 nginx 실행을 위해 필요한 파일들만 로컬에서 복사한 뒤 해당 이미지를 최종적으로 실행한다.

⇒ 최종적으로 사용하는 frontend 이미지에는 종속성도 없고, FROM이 nginx이다 보니 node 기반도 아니고, 정적파일인 빌드파일만 가져와서 실행시키기 때문에 빌드 사이즈가 작다.
공식문서를 읽어보면 이전 단계의 이미지들을 사용하려면 --from=0 처럼 단계의 순서를 써줘도 되고 위의 코드처럼 FROM ... AS frontend-build 처럼 AS 를 사용하여 단계에 이름을 붙여 --from=frontend-build 같이 사용해도 된다.

작은 BASE 이미지 사용

docker에서 base 이미지는 FROM node 처럼 docker 이미지를 생성할 때 배경이 되는 이미지를 말한다. 보통 컨테이너 환경에서 실행되는 애플리케이션을 위한 운영 체제나 런타임 환경들의 기본 세팅이라고 생각하면 된다.
이런 base이미지에는 alpine 이나 slim 같은 경량이미지가 존재해 경량이미지를 이용하여 이미지 사이즈를 줄일 수 있다.