kt-event-marketing/deployment/container/build-image.md

# Content Service 컨테이너 이미지 빌드 및 배포 가이드

## 1. 사전 준비사항

### 필수 소프트웨어
- **Docker Desktop**: Docker 컨테이너 실행 환경
- **JDK 23**: Java 애플리케이션 빌드
- **Gradle**: 프로젝트 빌드 도구

### 외부 서비스
- **Redis 서버**: 20.214.210.71:6379
- **Kafka 서버**: 4.230.50.63:9092
- **Replicate API**: Stable Diffusion 이미지 생성
- **Azure Blob Storage**: 이미지 CDN

## 2. 빌드 설정

### build.gradle 설정 (content-service/build.gradle)
```gradle
// 실행 JAR 파일명 설정
bootJar {
    archiveFileName = 'content-service.jar'
}
```

## 3. 배포 파일 구조

```
deployment/
└── container/
    ├── Dockerfile-backend          # 백엔드 서비스용 Dockerfile
    ├── docker-compose.yml          # Docker Compose 설정
    └── build-and-run.sh           # 자동화 배포 스크립트
```

## 4. 수동 빌드 및 배포

### 4.1 Gradle 빌드
```bash
# 프로젝트 루트에서 실행
./gradlew clean content-service:bootJar
```

### 4.2 Docker 이미지 빌드
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend

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

### 4.3 빌드된 이미지 확인
```bash
docker images | grep content-service
```

예상 출력:
```
content-service    latest    abc123def456    2 minutes ago    450MB
```

### 4.4 Docker Compose로 컨테이너 실행
```bash
docker-compose -f deployment/container/docker-compose.yml up -d
```

### 4.5 컨테이너 상태 확인
```bash
# 실행 중인 컨테이너 확인
docker ps

# 로그 확인
docker logs -f content-service

# 헬스체크
curl http://localhost:8084/actuator/health
```

## 5. 자동화 배포 스크립트 사용 (권장)

### 5.1 스크립트 실행
```bash
# 프로젝트 루트에서 실행
./deployment/container/build-and-run.sh
```

### 5.2 스크립트 수행 단계
1. Gradle 빌드
2. Docker 이미지 빌드
3. 이미지 확인
4. 기존 컨테이너 정리
5. 새 컨테이너 실행

## 6. 환경변수 설정

`docker-compose.yml`에 다음 환경변수가 설정되어 있습니다:

### 필수 환경변수
- `SPRING_PROFILES_ACTIVE`: Spring Profile (prod)
- `SERVER_PORT`: 서버 포트 (8084)
- `REDIS_HOST`: Redis 호스트
- `REDIS_PORT`: Redis 포트
- `REDIS_PASSWORD`: Redis 비밀번호
- `JWT_SECRET`: JWT 서명 키 (최소 32자)
- `REPLICATE_API_TOKEN`: Replicate API 토큰
- `AZURE_STORAGE_CONNECTION_STRING`: Azure Storage 연결 문자열
- `AZURE_CONTAINER_NAME`: Azure Storage 컨테이너 이름

### JWT_SECRET 요구사항
- **최소 길이**: 32자 이상 (256비트)
- **형식**: 영문자, 숫자 조합
- **예시**: `kt-event-marketing-jwt-secret-key-for-authentication-and-authorization-2025`

## 7. VM 배포

### 7.1 VM에 파일 전송
```bash
# VM으로 파일 복사 (예시)
scp -r deployment/ user@vm-host:/path/to/project/
scp docker-compose.yml user@vm-host:/path/to/project/deployment/container/
scp content-service/build/libs/content-service.jar user@vm-host:/path/to/project/content-service/build/libs/
```

### 7.2 VM에서 이미지 빌드
```bash
# VM에 SSH 접속 후
cd /path/to/project

# 이미지 빌드
docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="content-service/build/libs" \
  --build-arg ARTIFACTORY_FILE="content-service.jar" \
  -f deployment/container/Dockerfile-backend \
  -t content-service:latest .
```

### 7.3 VM에서 컨테이너 실행
```bash
# Docker Compose로 실행
docker-compose -f deployment/container/docker-compose.yml up -d

# 또는 직접 실행
docker run -d \
  --name content-service \
  -p 8084:8084 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e SERVER_PORT=8084 \
  -e REDIS_HOST=20.214.210.71 \
  -e REDIS_PORT=6379 \
  -e REDIS_PASSWORD=Hi5Jessica! \
  -e JWT_SECRET=kt-event-marketing-jwt-secret-key-for-authentication-and-authorization-2025 \
  -e REPLICATE_API_TOKEN=r8_Q33U00fSnpjYlHNIRglwurV446h7g8V2wkFFa \
  -e AZURE_STORAGE_CONNECTION_STRING="DefaultEndpointsProtocol=https;AccountName=blobkteventstorage;AccountKey=tcBN7mAfojbl0uGsOpU7RNuKNhHnzmwDiWjN31liSMVSrWaEK+HHnYKZrjBXXAC6ZPsuxUDlsf8x+AStd++QYg==;EndpointSuffix=core.windows.net" \
  -e AZURE_CONTAINER_NAME=content-images \
  content-service:latest
```

## 8. 모니터링 및 로그

### 8.1 컨테이너 상태 확인
```bash
docker ps
```

### 8.2 로그 확인
```bash
# 실시간 로그
docker logs -f content-service

# 최근 100줄
docker logs --tail 100 content-service
```

### 8.3 헬스체크
```bash
curl http://localhost:8084/actuator/health
```

예상 응답:
```json
{
  "status": "UP",
  "components": {
    "ping": {
      "status": "UP"
    },
    "redis": {
      "status": "UP"
    }
  }
}
```

## 9. Swagger UI 접근

배포 후 Swagger UI로 API 테스트 가능:
```
http://localhost:8084/swagger-ui/index.html
```

## 10. 이미지 생성 API 테스트

### 10.1 이미지 생성 요청
```bash
curl -X POST "http://localhost:8084/api/v1/content/images/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "eventDraftId": 1001,
    "industry": "고깃집",
    "location": "강남",
    "trends": ["가을", "단풍", "BBQ"],
    "styles": ["FANCY"],
    "platforms": ["INSTAGRAM"]
  }'
```

### 10.2 Job 상태 확인
```bash
curl http://localhost:8084/api/v1/content/jobs/{jobId}
```

## 11. 컨테이너 관리 명령어

### 11.1 컨테이너 중지
```bash
docker-compose -f deployment/container/docker-compose.yml down
```

### 11.2 컨테이너 재시작
```bash
docker-compose -f deployment/container/docker-compose.yml restart
```

### 11.3 컨테이너 삭제
```bash
# 컨테이너만 삭제
docker rm -f content-service

# 이미지도 삭제
docker rmi content-service:latest
```

## 12. 트러블슈팅

### 12.1 JWT 토큰 오류
**증상**: `Error creating bean with name 'jwtTokenProvider'`

**해결방법**:
- `JWT_SECRET` 환경변수가 32자 이상인지 확인
- docker-compose.yml에 올바르게 설정되어 있는지 확인

### 12.2 Redis 연결 오류
**증상**: `Unable to connect to Redis`

**해결방법**:
- Redis 서버(20.214.210.71:6379)가 실행 중인지 확인
- 방화벽 설정 확인
- 비밀번호 확인

### 12.3 Azure Storage 오류
**증상**: `Azure storage connection failed`

**해결방법**:
- `AZURE_STORAGE_CONNECTION_STRING`이 올바른지 확인
- Storage Account가 활성화되어 있는지 확인
- 컨테이너 이름(`content-images`)이 존재하는지 확인

## 13. 빌드 결과

### 빌드 수행 이력

#### 최신 빌드 (2025-10-28)

**1단계: JAR 빌드**
```bash
./gradlew content-service:clean content-service:bootJar
```

빌드 결과:
```
BUILD SUCCESSFUL in 8s
9 actionable tasks: 6 executed, 3 up-to-date
```

**2단계: Docker 이미지 빌드**
```bash
docker build \
  --platform linux/amd64 \
  --build-arg BUILD_LIB_DIR="content-service/build/libs" \
  --build-arg ARTIFACTORY_FILE="content-service.jar" \
  -f deployment/container/Dockerfile-backend \
  -t content-service:latest .
```

빌드 결과:
- ✅ Build stage 완료 (openjdk:23-oraclelinux8)
- ✅ Run stage 완료 (openjdk:23-slim)
- ✅ 이미지 생성 완료

**3단계: 이미지 확인**
```bash
docker images | grep content-service
```

확인 결과:
```
content-service    latest    ff73258c94cc    15 seconds ago    393MB
```

### 빌드 정보
- **서비스명**: content-service
- **JAR 파일**: content-service.jar
- **Docker 이미지**: content-service:latest
- **이미지 ID**: ff73258c94cc
- **이미지 크기**: 393MB
- **노출 포트**: 8084

### 빌드 일시
- **최신 빌드**: 2025-10-28
- **이전 빌드**: 2025-10-27

### 환경
- **Base Image**: openjdk:23-slim
- **Platform**: linux/amd64
- **User**: k8s (non-root)
- **Java Version**: 23