Docker Hub 이미지와 WSL을 사용해서 나만의 이미지 만들기

윈도우즈 WSL(Windows Subsystem for Linux)를 사용해서 Docker용 베이스 이미지나 배포 이미지를 만드는 절차를 알아보겠습니다. 도커 데스크탑을 사용할 수도 있으나 리눅스 시스템에서 도커를 운영할 예정이므로 공부한다는 생각으로 조금 귀찮은 길은 선택했습니다.

1. 단계: WSL 환경 준비 및 Docker 실행
   1. Windows의 WSL로 리눅스 사용하기 글 참고
   2. OCI VM(ubuntu)에 Nextcloud AIO 설치하기 글에서 도커 설치하기 부분 참고
   3. WSL의 Ubuntu 프롬프트에서 docker version 명령어를 실행하여 정상 작동하는지 확인합니다.
2. 단계: 빌드용 폴더 및 재료 준비
   1. 윈도우즈 C: 드라이브는 Ubuntu “/mnt/c”에, 윈도우즈 D: 드라이브는 Ubuntu “/mnt/d”에 마운팅되어 있습니다. 윈도우즈와 Ubuntu 간에 파일의 복사/이동이 쉽도록 “/mnt/d”에 하위 디렉토리로 wsl을 생성하겠습니다. 앞으로 모든 작업은 “/mnt/d/wsl” 디렉토리에 진행합니다.

      root@wsl-ubuntu:~# mkdir -p /mnt/d/wsl; cd !$
      mkdir -p /mnt/d/wsl; cd /mnt/d/wsl
      
      -- 베이스 이미지 저장용 디렉토리
      root@wsl-ubuntu:/mnt/d/wsl# mkdir -p ./docker/base-image
      -- Java Application 이미지 빌드용 디렉토리
      root@wsl-ubuntu:/mnt/d/wsl# mkdir -p ./docker/app-build
      

   2. eclipse-temurin:17-jre 이미지를 사용해서 베이스 이미지로 사용할 도커 이미지를 생성하겠습니다. 도커 허브에서 적당한 베이스 이미지를 찾으셔도 됩니다.

      -- # 1. 이미지 다운로드
      root@wsl-ubuntu:/mnt/d/wsl/docker/base-image# docker pull eclipse-temurin:17-jre
      17-jre: Pulling from library/eclipse-temurin
      5d3ecea993a0: Pull complete
      a3629ac5b9f4: Pull complete
      c4c6c77c0477: Pull complete
      c945adacc3c3: Pull complete
      5ccdf4191aa2: Pull complete
      99a5e8490fad: Download complete
      8ed6fca68e87: Download complete
      Digest: sha256:c81561cbc09964364afa412133d8eddf55b83efe5d39a64d0a5f109359bbfccc
      Status: Downloaded newer image for eclipse-temurin:17-jre
      docker.io/library/eclipse-temurin:17-jre
      root@wsl-ubuntu:/mnt/d/wsl/docker/base-image# docker image ls
      IMAGE                    ID             DISK USAGE   CONTENT SIZE   EXTRA
      eclipse-temurin:17-jre   c81561cbc099        408MB          106MB
      
      -- # 2. 이 단계는 필요없지만 운영서버에서 도커 이미지를 빌드할 경우를 대비하여 베이스 이미지를 추출합니다.(선택사항)
      ---- eclipse-temurin-17.tar 파일로 추출된 것을 확인합니다. 
      root@wsl-ubuntu:/mnt/d/wsl/docker/base-image# docker save -o eclipse-temurin-17.tar eclipse-temurin:17-jre
      root@wsl-ubuntu:/mnt/d/wsl/docker/base-image# ls -l
      total 103500
      -rwxrwxrwx 1 root root 105980416 Feb 12 13:35 eclipse-temurin-17.tar
      
      -- # 3. 베이스 이미지가 정상적으로 설치되었는지 확인해 봅니다. 환경변수 $JAVA_HOME이 설정되어 있습니다.(선택사항)
      root@wsl-ubuntu:/mnt/d/wsl/docker/base-image# docker run -it eclipse-temurin:17-jre /bin/bash
      root@a1c8f8954fdd:/# cd $JAVA_HOME
      root@a1c8f8954fdd:/opt/java/openjdk# ll
      total 32
      drwxr-xr-x  6 root root 4096 Feb  5 22:18 ./
      drwxr-xr-x  3 root root 4096 Feb  5 22:18 ../
      drwxr-xr-x  2 root root 4096 Jan 20 22:33 bin/
      drwxr-xr-x  5 root root 4096 Jan 20 22:29 conf/
      drwxr-xr-x 52 root root 4096 Jan 20 22:29 legal/
      drwxr-xr-x  5 root root 4096 Jan 20 22:33 lib/
      -rw-r--r--  1 root root 2400 Jan 20 22:33 NOTICE
      -rw-r--r--  1 root root 1626 Jan 20 22:33 release
      

3. 단계: Java Application을 빌드하기 위한 Dockerfile을 작성하고 빌드합니다.
   1. Eclipse에서 빌드한 jar 파일(pda-backend.jar)을 Java Application 이미지 빌드용 디렉토리로 복사합니다.
   2. Java Application 이미지 빌드용 디렉토리로 이동한 후 Dockerfile를 작성합니다.

      root@wsl-ubuntu:/mnt/d/wsl/docker/app-build# vi Dockerfile 
      # 1. 베이스 이미지 설정 (Eclipse Temurin Java 17 JRE)
      FROM eclipse-temurin:17-jre
      
      # 2. 환경 변수 설정 (이미 설정되어 있지만, 명시적으로 관리하기 위함)
      # Temurin 이미지의 기본 JAVA_HOME은 보통 /opt/java/openjdk 입니다.
      ENV JAVA_HOME=/opt/java/openjdk
      ENV PATH=$JAVA_HOME/bin:$PATH
      ENV TZ=Asia/Seoul
      ENV LC_ALL=C.UTF-8
      
      # 3. 작업 디렉토리 설정
      WORKDIR /app
      
      # 4. 앱 실행에 필요한 파일 복사
      # Eclipse에서 빌드한 jar 파일 이름을 확인 후 수정하세요.
      COPY ./pda-backend.jar pda-backend.jar
      
      # 5. 보안을 위한 비관리자 실행 (선택 사항이나 권장)
      # root가 아닌 계정으로 실행하면 보안상 더 안전합니다.
      # RUN useradd -m myuser
      # USER myuser
      
      # 6. 컨테이너 내부 포트 개방 선언, 
      EXPOSE 8080
      
      # 7. 실행 명령어 (ENTRYPOINT는 CMD보다 변경이 어려워 실행형 이미지에 적합합니다)
      # -XX:+UseContainerSupport: 컨테이너의 메모리 제한을 자바가 인식하게 함 (Java 17은 기본 활성)
      # -XX:MaxRAMPercentage=75.0: 할당된 컨테이너 메모리의 75%를 사용
      ENTRYPOINT ["java", "-Xms512m", "-Xmx512m", "-XX:+UseContainerSupport", "-XX:MaxRAMPercentage=75.0", "-jar", "pda-backend.jar"]
      

   3. Java Application 이미지를 빌드합니다.

      root@wsl-ubuntu:/mnt/d/wsl/docker/app-build# docker build -t pda-backend-17:1.0 .
      

4. 단계: 빌드된 Java Application 이미지를 추출하고 운영서버로 전송합니다.
   1. 빌드된 Java Application 이미지를 추출합니다.

      root@wsl-ubuntu:/mnt/d/wsl/docker/app-build# docker save -o ./pda-backend-17-v1.tar pda-backend-17:1.0
      

   2. FileZilla 등을 이용해서 추출된 Java Application 이미지를 운영서버로 전송합니다.
5. 단계: 전송받은 Java Application 이미지로 운영서버에서 서비스를 제공합니다. 인터넷이 연결되지 않은 운영서버에서 도커 사용하는 방법을 참고바랍니다.
   1. 운영서버에 로그인한 후 Java Application 이미지(pda-backend-17-v1.tar)를 저장한 디렉토리에서 아래 명령어를 실행하여 도커 엔진에 다시 “이미지” 상태로 인식시킵니다.

      $ sudo docker load -i pda-backend-17-v1.tar
      

   2. 로드된 Java Application을 컨테이너로 실행합니다

      -- -e "JAVA_OPTS=..." 옵션을 사용하여 애플리케이션에 필요한 추가 환경변수를 넘길 수 있습니다.
      -- -p 9090:8080 옵션은 호스트 포트 9090 요청을 컨테이너 8080으로 포워딩시킵니다.
      $ sudo docker run -d \
        --name pda-service \
        -p 9090:8080 \
        --memory="1g" \
        --restart always \
        -e "JAVA_OPTS=-XX:MaxRAMPercentage=75.0" \
        pda-backend-17:1.0
      

   3. Java Application 서비스를 DB와 연동해야 한다면, 실행 시 DB 접속 정보를 환경변수로 넘겨주는 것이 좋습니다.

      # 예시: DB 접속 정보를 실행 시점에 주입
      docker run -d ... \
        -e "SPRING_DATASOURCE_URL=jdbc:oracle:thin:@db.server.ip.address:1521:ORACLE_SID" \
        -e "SPRING_DATASOURCE_USERNAME=user" \
        -e "SPRING_DATASOURCE_PASSWORD=pass" \
        pda-backend-17:1.0