phonebill/deployment/container/build-image.md

백엔드 컨테이너 이미지 빌드 결과서

작업 개요

• 작업일시: 2025-01-10
• 작업자: 최운영/데옵스
• 작업 목표: 백엔드 마이크로서비스들의 컨테이너 이미지 생성

빌드 대상 서비스

총 5개의 백엔드 서비스에 대한 컨테이너 이미지를 생성했습니다.

1. api-gateway: API Gateway 서비스
2. user-service: 사용자 관리 서비스
3. bill-service: 요금 조회 서비스
4. product-service: 상품 변경 서비스
5. kos-mock: KOS 시스템 목업 서비스

사전 작업

1. 서비스별 bootJar 설정 추가

각 서비스의 build.gradle 파일에 일관된 JAR 파일명 설정을 추가했습니다.

bootJar {
    archiveFileName = '{서비스명}.jar'
}

2. 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"]

3. 서비스별 빌드

모든 서비스에 대해 Gradle 빌드를 수행했습니다.

./gradlew api-gateway:clean api-gateway:bootJar
./gradlew user-service:clean user-service:bootJar
./gradlew bill-service:clean bill-service:bootJar
./gradlew product-service:clean product-service:bootJar
./gradlew kos-mock:clean kos-mock:bootJar

컨테이너 이미지 빌드

각 서비스별로 다음 명령어를 사용하여 컨테이너 이미지를 빌드했습니다.

API Gateway

DOCKER_FILE=deployment/container/Dockerfile-backend
service=api-gateway

docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="${service}/build/libs" \
  --build-arg ARTIFACTORY_FILE="${service}.jar" \
  -f ${DOCKER_FILE} \
  -t ${service}:latest .

User Service

DOCKER_FILE=deployment/container/Dockerfile-backend
service=user-service

docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="${service}/build/libs" \
  --build-arg ARTIFACTORY_FILE="${service}.jar" \
  -f ${DOCKER_FILE} \
  -t ${service}:latest .

Bill Service

DOCKER_FILE=deployment/container/Dockerfile-backend
service=bill-service

docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="${service}/build/libs" \
  --build-arg ARTIFACTORY_FILE="${service}.jar" \
  -f ${DOCKER_FILE} \
  -t ${service}:latest .

Product Service

DOCKER_FILE=deployment/container/Dockerfile-backend
service=product-service

docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="${service}/build/libs" \
  --build-arg ARTIFACTORY_FILE="${service}.jar" \
  -f ${DOCKER_FILE} \
  -t ${service}:latest .

KOS Mock Service

DOCKER_FILE=deployment/container/Dockerfile-backend
service=kos-mock

docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="${service}/build/libs" \
  --build-arg ARTIFACTORY_FILE="${service}.jar" \
  -f ${DOCKER_FILE} \
  -t ${service}:latest .

빌드 결과

성공적으로 생성된 이미지들

서비스명	이미지 태그	이미지 ID	크기	생성 시간
api-gateway	latest	5f4a2a5527b8	329MB	3분 전
user-service	latest	a8a85ba0b703	376MB	2분 전
bill-service	latest	b77190090a40	385MB	1분 전
product-service	latest	5a6fba790ca3	392MB	1분 전
kos-mock	latest	3f5878cf2f1e	372MB	35초 전

이미지 검증 명령어 실행 결과

$ docker images | grep -E "(api-gateway|user-service|bill-service|product-service|kos-mock)"
kos-mock                                                 latest    3f5878cf2f1e   35 seconds ago       372MB
product-service                                          latest    5a6fba790ca3   About a minute ago   392MB
bill-service                                             latest    b77190090a40   About a minute ago   385MB
user-service                                             latest    a8a85ba0b703   2 minutes ago        376MB
api-gateway                                              latest    5f4a2a5527b8   3 minutes ago        329MB

빌드 특징

멀티 스테이지 빌드

• Build Stage: OpenJDK 23-oraclelinux8 사용하여 JAR 파일 복사
• Runtime Stage: OpenJDK 23-slim 사용하여 경량화된 실행 환경 구성

보안 강화

• 비루트 사용자 k8s 생성 및 사용
• 적절한 파일 소유권 및 권한 설정
• 최소 권한 원칙 적용

플랫폼 호환성

• --platform linux/amd64 옵션으로 AMD64 아키텍처 지원
• 쿠버네티스 클러스터 배포에 적합한 형태

다음 단계

1. 컨테이너 레지스트리 푸시: ACR 또는 Docker Hub에 이미지 푸시
2. 쿠버네티스 매니페스트 작성: Deployment, Service 등 K8s 리소스 정의
3. 헬름 차트 작성: 패키지 관리를 위한 Helm 차트 구성
4. CI/CD 파이프라인 통합: 자동화된 빌드 및 배포 파이프라인 구축

주요 성과

✅ 모든 백엔드 서비스 컨테이너화 완료 (5개 서비스)
✅ 멀티 스테이지 빌드로 최적화된 이미지 (평균 360MB)
✅ 보안 강화된 컨테이너 구성 (비루트 사용자)
✅ 일관된 빌드 프로세스 (표준화된 Dockerfile)
✅ 쿠버네티스 배포 준비 완료

모든 백엔드 서비스들이 성공적으로 컨테이너화되었으며, 프로덕션 환경 배포를 위한 준비가 완료되었습니다.