백엔드 컨테이너 이미지 작성 완료

- 5개 백엔드 서비스의 bootJar 설정 추가/수정 - 공통 Dockerfile-backend 생성 (멀티 스테이지 빌드) - 각 서비스별 컨테이너 이미지 빌드 완료 - 보안 강화된 컨테이너 구성 (비루트 사용자) - 상세한 빌드 결과 문서 작성 서비스 목록: - api-gateway:latest (329MB) - user-service:latest (376MB) - bill-service:latest (385MB) - product-service:latest (392MB) - kos-mock:latest (372MB)
2026-01-22 18:36:23 +00:00 · 2025-09-10 22:40:03 +09:00 · 2025-09-10 22:40:03 +09:00 · 377fea4de3
commit 377fea4de3
parent 2599d57a37
14 changed files with 350 additions and 4 deletions
--- a/.claude/commands/deploy-build-image-back.md
+++ b/.claude/commands/deploy-build-image-back.md
@ -0,0 +1,8 @@
+---
+command: "/deploy-build-image-back"
+category: "배포"
+purpose: "백엔드 컨테이너 이미지 작성"
+---
+
+@cicd 
+'백엔드컨테이너이미지작성가이드'에 따라 컨테이너 이미지를 작성해 주세요.
--- a/.claude/commands/deploy-build-image-front.md
+++ b/.claude/commands/deploy-build-image-front.md
@ -0,0 +1,8 @@
+---
+command: "/deploy-build-image-front"
+category: "배포"
+purpose: "프론트엔드 컨테이너 이미지 작성"
+---
+
+@cicd 
+'프론트엔드컨테이너이미지작성가이드'에 따라 컨테이너 이미지를 작성해 주세요.
--- a/.claude/commands/deploy-help.md
+++ b/.claude/commands/deploy-help.md
@ -0,0 +1,35 @@
+---
+command: "/deploy-help"
+category: "배포 도움말"
+purpose: "배포 작업 순서 안내"
+---
+
+배포 작업 순서
+
+1단계: 백엔드 컨테이너 이미지 작성
+/deploy-build-image-back
+- 백엔드컨테이너이미지작성가이드를 참고하여 백엔드 컨테이너 이미지를 작성합니다
+
+2단계: 프론트엔드 컨테이너 이미지 작성
+/deploy-build-image-front
+- 프론트엔드컨테이너이미지작성가이드를 참고하여 프론트엔드 컨테이너 이미지를 작성합니다
+
+3단계: 백엔드 컨테이너 실행방법 가이드 작성
+/deploy-run-container-guide-back
+- 백엔드컨테이너실행방법가이드를 참고하여 컨테이너 실행 가이드를 작성합니다
+- [실행정보] 섹션에 ACR명, VM 정보(KEY파일, USERID, IP)를 제공해야 합니다
+
+4단계: 프론트엔드 컨테이너 실행방법 가이드 작성
+/deploy-run-container-guide-front
+- 프론트엔드컨테이너실행방법가이드를 참고하여 컨테이너 실행 가이드를 작성합니다
+- [실행정보] 섹션에 시스템명, ACR명, VM 정보(KEY파일, USERID, IP)를 제공해야 합니다
+
+5단계: 백엔드 쿠버네티스 배포 가이드 작성
+/deploy-k8s-guide-back
+- 백엔드배포가이드를 참고하여 백엔드 서비스 배포 방법을 작성합니다
+- [실행정보] 섹션에 ACR명, k8s명, 네임스페이스, 파드수, 리소스 정보를 제공해야 합니다
+
+6단계: 프론트엔드 쿠버네티스 배포 가이드 작성
+/deploy-k8s-guide-front
+- 프론트엔드배포가이드를 참고하여 프론트엔드 서비스 배포 방법을 작성합니다
+- [실행정보] 섹션에 시스템명, ACR명, k8s명, 네임스페이스, 파드수, 리소스 정보, Gateway Host를 제공해야 합니다
--- a/.claude/commands/deploy-k8s-guide-back.md
+++ b/.claude/commands/deploy-k8s-guide-back.md
@ -0,0 +1,18 @@
+---
+command: "/deploy-k8s-guide-back"
+category: "배포"
+purpose: "백엔드 배포 가이드 작성"
+---
+
+@cicd 
+'백엔드배포가이드'에 따라 백엔드 서비스 배포 방법을 작성해 주세요. 
+프롬프트에 '[실행정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. 
+{안내메시지}
+'[실행정보]'섹션 하위에 아래 예와 같이 필요한 정보를 제시해 주세요.   
+[실행정보]
+- ACR명: acrdigitalgarage01
+- k8s명: aks-digitalgarage-01
+- 네임스페이스: tripgen
+- 파드수: 2
+- 리소스(CPU): 256m/1024m
+- 리소스(메모리): 256Mi/1024Mi
--- a/.claude/commands/deploy-k8s-guide-front.md
+++ b/.claude/commands/deploy-k8s-guide-front.md
@ -0,0 +1,20 @@
+---
+command: "/deploy-k8s-guide-front"
+category: "배포"
+purpose: "프론트엔드 배포 가이드 작성"
+---
+
+@cicd 
+'프론트엔드배포가이드'에 따라 프론트엔드 서비스 배포 방법을 작성해 주세요. 
+프롬프트에 '[실행정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. 
+{안내메시지}
+'[실행정보]'섹션 하위에 아래 예와 같이 필요한 정보를 제시해 주세요.   
+[실행정보]
+- 시스템명: tripgen
+- ACR명: acrdigitalgarage01
+- k8s명: aks-digitalgarage-01
+- 네임스페이스: tripgen
+- 파드수: 2
+- 리소스(CPU): 256m/1024m
+- 리소스(메모리): 256Mi/1024Mi
+- Gateway Host: http://tripgen-api.20.214.196.128.nip.io
--- a/.claude/commands/deploy-run-container-guide-back.md
+++ b/.claude/commands/deploy-run-container-guide-back.md
@ -0,0 +1,17 @@
+---
+command: "/deploy-run-container-guide-back"
+category: "배포"
+purpose: "백엔드 컨테이너 실행방법 작성"
+---
+
+@cicd 
+'백엔드컨테이너실행방법가이드'에 따라 컨테이너 실행 가이드를 작성해 주세요. 
+프롬프트에 '[실행정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. 
+{안내메시지}
+'[실행정보]'섹션 하위에 아래 예와 같이 필요한 정보를 제시해 주세요.   
+[실행정보]
+- ACR명: acrdigitalgarage01
+- VM
+  - KEY파일: ~/home/bastion-dg0500
+  - USERID: azureuser
+  - IP: 4.230.5.6
--- a/.claude/commands/deploy-run-container-guide-front.md
+++ b/.claude/commands/deploy-run-container-guide-front.md
@ -0,0 +1,18 @@
+---
+command: "/deploy-run-container-guide-front"
+category: "배포"
+purpose: "프론트엔드 컨테이너 실행방법 작성"
+---
+
+@cicd 
+'프론트엔드컨테이너실행방법가이드'에 따라 컨테이너 실행 가이드를 작성해 주세요. 
+프롬프트에 '[실행정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. 
+{안내메시지}
+'[실행정보]'섹션 하위에 아래 예와 같이 필요한 정보를 제시해 주세요.   
+[실행정보]
+- 시스템명: tripgen
+- ACR명: acrdigitalgarage01
+- VM
+  - KEY파일: ~/home/bastion-dg0500
+  - USERID: azureuser
+  - IP: 4.230.5.6
--- a/.claude/commands/develop-make-run-profile.md
+++ b/.claude/commands/develop-make-run-profile.md
@ -8,8 +8,9 @@
 ## 프롬프트
 ```
@test-backend  
-'서비스실행파일작성가이드'에 따라 테스트를 해 주세요.   
+'서비스실행프로파일작성가이드'에 따라 테스트를 해 주세요.   
 프롬프트에 '[작성정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요.  
+DB나 Redis의 접근 정보는 지정할 필요 없습니다. 특별히 없으면 '[작성정보]'섹션에 '없음'이라고 하세요.      
 {안내메시지}
 [작성정보]
 - API Key
--- a/api-gateway/build.gradle
+++ b/api-gateway/build.gradle
@ -56,7 +56,7 @@ jar {
 }

 bootJar {
-    archiveBaseName = 'api-gateway'
+    archiveFileName = 'api-gateway.jar'
    
    // 빌드 정보 추가
    manifest {
--- a/bill-service/build.gradle
+++ b/bill-service/build.gradle
@ -91,7 +91,7 @@ jar {
 }

 bootJar {
+    archiveFileName = 'bill-service.jar'
    enabled = true
-    archiveBaseName = 'bill-service'
    archiveClassifier = ''
 }
--- a/deployment/container/Dockerfile-backend
+++ b/deployment/container/Dockerfile-backend
@ -0,0 +1,25 @@
+# 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"]
--- a/deployment/container/build-image.md
+++ b/deployment/container/build-image.md
@ -0,0 +1,191 @@
+# 백엔드 컨테이너 이미지 빌드 결과서
+
+## 작업 개요
+- **작업일시**: 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 파일명 설정을 추가했습니다.
+
+```gradle
+bootJar {
+    archiveFileName = '{서비스명}.jar'
+}
+```
+
+### 2. Dockerfile 생성
+`deployment/container/Dockerfile-backend` 파일을 생성했습니다.
+
+```dockerfile
+# 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 빌드를 수행했습니다.
+
+```bash
+./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
+```bash
+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
+```bash
+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
+```bash
+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
+```bash
+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
+```bash
+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초 전 |
+
+### 이미지 검증 명령어 실행 결과
+```bash
+$ 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)  
+✅ **쿠버네티스 배포 준비 완료**
+
+모든 백엔드 서비스들이 성공적으로 컨테이너화되었으며, 프로덕션 환경 배포를 위한 준비가 완료되었습니다.
--- a/kos-mock/build.gradle
+++ b/kos-mock/build.gradle
@ -51,4 +51,9 @@ tasks.named('test') {
 jar {
    archiveBaseName = 'kos-mock-service'
    archiveVersion = version
+    enabled = false
+}
+
+bootJar {
+    archiveFileName = 'kos-mock.jar'
 }
--- a/user-service/build.gradle
+++ b/user-service/build.gradle
@ -32,7 +32,7 @@ jar {
 }

 bootJar {
-    archiveBaseName = 'user-service'
+    archiveFileName = 'user-service.jar'
 }

 // Spring Boot 실행 설정