kt-event-marketing/claude/build-image-back.md

# 백엔드 컨테이너이미지 작성가이드

[요청사항]  
- 백엔드 각 서비스를의 컨테이너 이미지 생성
- 실제 빌드 수행 및 검증까지 완료
- '[결과파일]'에 수행한 명령어를 포함하여 컨테이너 이미지 작성 과정 생성 

[작업순서]
- 서비스명 확인   
  서비스명은 settings.gradle에서 확인 
  
  예시) include 'common'하위의 4개가 서비스명임.  
  ```
  rootProject.name = 'tripgen'

  include 'common'
  include 'user-service'
  include 'location-service'
  include 'ai-service'
  include 'trip-service'
  ```  

- 실행Jar 파일 설정   
  실행Jar 파일명을 서비스명과 일치하도록 build.gradle에 설정 합니다.   
  ```
  bootJar {
      archiveFileName = '{서비스명}.jar'
  }
  ```

- Dockerfile 생성   
  아래 내용으로 deployment/container/Dockerfile-backend 생성  
  ```
  # Build stage
  FROM openjdk:23-oraclelinux8 AS builder
  ARG BUILD_LIB_DIR
  ARG ARTIFACTORY_FILE
  COPY ${BUILD_LIB_DIR}/${ARTIFACTORY_FILE} app.jar

  # Run stage
  FROM openjdk:23-slim
  ENV USERNAME=k8s
  ENV ARTIFACTORY_HOME=/home/${USERNAME}
  ENV JAVA_OPTS=""

  # Add a non-root user
  RUN adduser --system --group ${USERNAME} && \
      mkdir -p ${ARTIFACTORY_HOME} && \
      chown ${USERNAME}:${USERNAME} ${ARTIFACTORY_HOME}

  WORKDIR ${ARTIFACTORY_HOME}
  COPY --from=builder app.jar app.jar
  RUN chown ${USERNAME}:${USERNAME} app.jar

  USER ${USERNAME}

  ENTRYPOINT [ "sh", "-c" ]
  CMD ["java ${JAVA_OPTS} -jar app.jar"]
  ```

- 컨테이너 이미지 생성    
  아래 명령으로 각 서비스 빌드. shell 파일을 생성하지 말고 command로 수행.   
  서브에이젼트를 생성하여 병렬로 수행.   
  ```
  DOCKER_FILE=deployment/container/Dockerfile-backend
  service={서비스명}

  docker build \
    --platform linux/amd64 \
    --build-arg BUILD_LIB_DIR="${서비스명}/build/libs" \
    --build-arg ARTIFACTORY_FILE="${서비스명}.jar" \
    -f ${DOCKER_FILE} \
    -t ${서비스명}:latest .
  ```
- 생성된 이미지 확인   
  아래 명령으로 모든 서비스의 이미지가 빌드되었는지 확인   
  ```
  docker images | grep {서비스명}
  ```

[결과파일]
deployment/container/build-image.md