Compare commits

...

14 Commits

Author SHA1 Message Date
ondal
698c146393 Jenkinsfile에 Setup Kubernetes2 스테이지 추가
- namespace 생성 스테이지 복원

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 14:29:20 +09:00
ondal
696f9a4fc6 kustomization.yaml에서 commonLabels 제거
- app, version 레이블 중복 적용 방지

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 14:28:33 +09:00
ondal
250f5943ea Jenkinsfile props.namespace 변수 참조 개선
- Setup Kubernetes 스테이지 제거 (사용자 수정 반영)
- Update Kustomize & Deploy 스테이지에서 namespace 변수 로컬 정의

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 14:03:55 +09:00
ondal
3d8ee6802c Jenkinsfile Setup Kubernetes 스테이지에 로깅 추가
- Blue Ocean에서 스테이지 상태가 명확히 표시되도록 echo 문 추가
- 시작/완료 로그로 진행 상황 가시성 개선

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 13:52:55 +09:00
ondal
9dc1bfb926 Jenkinsfile SKIP_SONARQUBE 파라미터 기본값 설정
- SKIP_SONARQUBE 파라미터 기본값을 'true'로 설정

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 13:31:58 +09:00
ondal
ab27787951 Jenkinsfile에서 kubectl context 설정 제거
- kubectl config use-context 명령 제거 (Jenkins 환경에서 불필요)
- deploy_env_vars_dev에서 context 변수 제거

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 13:26:15 +09:00
ondal
0f054109bb Jenkins CI/CD 파이프라인 업데이트
- Jenkinsfile 개선: SonarQube 분석, Quality Gate 추가
- 환경별 설정 파일 업데이트 (dev/staging/prod)
- Kustomize base 및 overlay 파일 정리
- prod 환경 overlay 파일 추가
- 배포 스크립트 및 검증 스크립트 업데이트
- 파이프라인 가이드 문서 업데이트

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 12:57:35 +09:00
ondal
b467b84426 Jenkinsfile kubectl 이미지를 azure-kubectl로 변경
- kubectl 컨테이너 이미지를 hiondal/azure-kubectl:latest로 변경
- Azure 환경 지원을 위한 이미지 교체

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:33:25 +09:00
ondal
37136c6669 Jenkinsfile에서 SonarQube 분석 스테이지 제거
- SonarQube Analysis & Quality Gate 스테이지 삭제
- 빌드 파이프라인 단순화

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:24:05 +09:00
ondal
1711363e91 Jenkinsfile kubectl 이미지 변경
- bitnami/kubectl → lachlanevenson/k8s-kubectl로 변경
- non-root 사용자 권한 문제 해결

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:16:01 +09:00
ondal
606108d85f Jenkinsfile에서 tolerations 설정 제거
- CI/CD Pod에서 불필요한 tolerations 설정 제거
- dedicated=cicd 노드 제약조건 해제

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:12:29 +09:00
ondal
ff940a676b Jenkinsfile에 cloud 파라미터 추가
- podTemplate에 cloud: 'k8s' 설정 추가
- Jenkins Kubernetes 클라우드 설정과 연결

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:07:04 +09:00
ondal
aac5710766 Jenkinsfile에서 불필요한 context 스위치 제거
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 10:57:57 +09:00
ondal
f12fed5de9 Jenkins 기반 CI/CD 파이프라인 구성
- Kustomize 기반 환경별(dev/staging/prod) 매니페스트 관리
- Jenkins 파이프라인 스크립트 작성 (Podman, Gradle, kubectl 컨테이너)
- SonarQube 코드 품질 분석 및 Quality Gate 연동
- 수동 배포 및 리소스 검증 스크립트 추가
- k8s 매니페스트 구조 재정리 (configmaps, secrets, deployments, services 분리)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 10:23:32 +09:00
113 changed files with 2776 additions and 3451 deletions

379
CLAUDE.md
View File

@ -186,6 +186,383 @@ QA Engineer
- **예시**: `kubectl exec -n phonebill-dev product-change-postgres-dev-postgresql-0 -c postgresql -- bash -c 'PGPASSWORD="$POSTGRES_POSTGRES_PASSWORD" psql -U postgres -d product_change_db -c "ALTER TABLE product_change.pc_product_change_history ALTER COLUMN customer_id TYPE VARCHAR(100);"'` - **예시**: `kubectl exec -n phonebill-dev product-change-postgres-dev-postgresql-0 -c postgresql -- bash -c 'PGPASSWORD="$POSTGRES_POSTGRES_PASSWORD" psql -U postgres -d product_change_db -c "ALTER TABLE product_change.pc_product_change_history ALTER COLUMN customer_id TYPE VARCHAR(100);"'`
[가이드] [가이드]
``` ```
$(cat claude/guide.md) # Clauding Guide
최종 수정일시: 2025-11-18 20:10
## 서비스기획 가이드
- 서비스기획프롬프트
- 설명: 유저스토리 작성 등 서비스 기획을 위한 프롬프트 예시
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/prompt/02.think-prompt.md
- 파일명: think-prompt.md
- 서비스기획가이드
- 설명: 서비스 기획 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/think/think-guide.md
- 파일명: think-guide.md
---
## 설계 가이드
- 설계실행프롬프트
- 설명: 각 설계 단계 실행을 위한 프롬프트 모음
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/prompt/03.design-prompt.md
- 파일명: design-prompt.md
- 공통설계원칙
- 설명: 모든 설계 시 적용할 공통설계원칙
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/common-principles.md
- 파일명: common-principles.md
- UI/UX설계가이드
- 설명: UI/UX 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/uiux-design.md
- 파일명: uiux-design.md
- 프로토타입작성가이드
- 설명: 프로토타입 작성 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/uiux-prototype.md
- 파일명: uiux-prototype.md
- 클라우드아키텍처패턴선정가이드
- 설명: 클라우드 아키텍처 패턴 선정 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/architecture-patterns.md
- 파일명: architecture-patterns.md
- 논리아키텍처설계가이드
- 설명: 논리 아키텍처 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/logical-architecture-design.md
- 파일명: logical-architecture-design.md
- API설계가이드
- 설명: API 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/api-design.md
- 파일명: api-design.md
- 외부시퀀스설계가이드
- 설명: 외부 시퀀스 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/sequence-outer-design.md
- 파일명: sequence-outer-design.md
- 내부시퀀스설계 가이드
- 설명: 내부 시퀀스 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/sequence-inner-design.md
- 파일명: sequence-inner-design.md
- 클래스설계가이드
- 설명: 클래스 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/class-design.md
- 파일명: class-design.md
- 데이터설계가이드
- 설명: 데이터 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/data-design.md
- 파일명: data-design.md
- HighLevel아키텍처정의가이드
- 설명: 상위수준 아키텍처 정의 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/architecture-highlevel.md
- 파일명: architecture-highlevel.md
- 물리아키텍처설계가이드
- 설명: 물리 아키텍처 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/physical-architecture-design.md
- 파일명: physical-architecture-design.md
- 프론트엔드설계가이드
- 설명: 프론트엔드 설계 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/design/frontend-design.md
- 파일명: frontend-design.md
---
## 개발 가이드
- 개발실행프롬프트
- 설명: 각 개발 단계 실행을 위한 프롬프트 모음
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/prompt/04.develop-prompt.md
- 파일명: develop-prompt.md
- 데이터베이스설치계획서가이드
- 설명: 데이터베이스 설치 방법 안내 요청 시 참조
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/database-plan.md
- 파일명: database-plan.md
- 데이터베이스설치가이드
- 설명: 데이터베이스 설치 방법 안내 요청 시 참조
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/database-install.md
- 파일명: database-install.md
- MQ설치게획서가이드
- 설명: Message Queue 설치 방법 안내 요청 시 참조
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/mq-plan.md
- 파일명: mq-plan.md
- MQ설치가이드
- 설명: Message Queue 설치 방법 안내 요청 시 참조
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/mq-install.md
- 파일명: mq-install.md
- 백엔드개발가이드
- 설명: 백엔드 개발 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/dev-backend.md
- 파일명: dev-backend.md
- GradleWrapper생성가이드
- 설명: Gradle Wrapper 생성 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/gradle-wrapper.md
- 파일명: gradle-wrapper.md
- 서비스실행프로파일작성가이드
- 설명: 백엔드 서비스 실행 프로파일 작성 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/make-run-profile.md
- 파일명: make-run-profile.md
- 백엔드테스트가이드
- 설명: 백엔드 테스트 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/test-backend.md
- 파일명: test-backend.md
- 프론트엔드개발가이드
- 설명: 프론트엔드 개발 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/develop/dev-frontend.md
- 파일명: dev-frontend.md
---
## 배포 가이드
- 배포실행프롬프트
- 설명: 각 배포 단계 실행을 위한 프롬프트 모음
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/prompt/05.deploy-prompt.md
- 파일명: deploy-prompt.md
- 백엔드컨테이너이미지작성가이드
- 설명: 백엔드 컨테이너 이미지 작성 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/build-image-back.md
- 파일명: build-image-back.md
- 프론트엔드컨테이너이미지작성가이드
- 설명: 프론트엔드 컨테이너 이미지 작성 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/build-image-front.md
- 파일명: build-image-front.md
- 백엔드컨테이너실행방법가이드
- 설명: 백엔드 컨테이너 실행방법 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/run-container-guide-back.md
- 파일명: run-container-guide-back.md
- 프론트엔드컨테이너실행방법가이드
- 설명: 프론트엔드 컨테이너 실행방법 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/run-container-guide-front.md
- 파일명: run-container-guide-front.md
- 백엔드배포가이드
- 설명: 백엔드 서비스를 쿠버네티스 클러스터에 배포하는 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-k8s-back.md
- 파일명: deploy-k8s-back.md
- 프론트엔드배포가이드
- 설명: 프론트엔드 서비스를 쿠버네티스 클러스터에 배포하는 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-k8s-front.md
- 파일명: deploy-k8s-front.md
- 백엔드Jenkins파이프라인작성가이드
- 설명: 백엔드 서비스를 Jenkins를 이용하여 CI/CD하는 배포 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-jenkins-cicd-back.md
- 파일명: deploy-jenkins-cicd-back.md
- 프론트엔드Jenkins파이프라인작성가이드
- 설명: 프론트엔드 서비스를 Jenkins를 이용하여 CI/CD하는 배포 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-jenkins-cicd-front.md
- 파일명: deploy-jenkins-cicd-front.md
- 백엔드GitHubActions파이프라인작성가이드
- 설명: 백엔드 서비스를 GitHub Actions를 이용하여 CI/CD하는 배포 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-actions-cicd-back.md
- 파일명: deploy-actions-cicd-back.md
- 프론트엔드GitHubActions파이프라인작성가이드
- 설명: 프론트엔드 서비스를 GitHub Actions를 이용하여 CI/CD하는 배포 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-actions-cicd-front.md
- 파일명: deploy-actions-cicd-front.md
- ArgoCD파이프라인준비가이드
- 설명: 프론트엔드/백엔드 서비스를 ArgoCD를 이용하여 CI와 CD를 분리하는 가이드
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/deploy/deploy-argocd-cicd.md
- 파일명: deploy-argocd-cicd.md
## 참조 문서
- 프로젝트지침템플릿
- 설명: 프로젝트 지침인 CLAUDE.md 파일 템플릿
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/instruction-template.md
- 파일명: instruction-template.md
- 유저스토리작성방법
- 설명: 유저스토리 형식과 작성법
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/유저스토리작성방법.md
- 파일명: userstory-writing.md
- 유저스토리예제
- 설명: 유저스토리 예제
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/samples/sample-%EC%9C%A0%EC%A0%80%EC%8A%A4%ED%86%A0%EB%A6%AC.md
- 파일명: sample-userstory.md
- 클라우드아키텍처패턴요약표
- 설명: 클라우드 디자인 패턴 요약표
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/Cloud%20Design%20Patterns(%EA%B0%9C%EC%9A%94).md
- 파일명: cloud-design-patterns.md
- HighLevel아키텍처정의서템플릿
- 설명: MSA 7대 컴포넌트별로 상위 수준의 아키텍처를 정의한 문서
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/highlevel-architecture-template.md
- 파일명: highlevel-architecture-template.md
- 제품별버전가이드
- 설명: 개발언어, 개발 프레임워크, AI제품 등의 버전 참조를 위한 페이지 링크 제공
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/제품버전참조.md
- 파일명: version-link.md
- 백킹서비스설치방법
- 설명: 데이터베이스, Message Queue 등 백킹서비스설치방법 설명
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/references/백킹서비스설치방법.md
- 파일명: backing-service-method.md
---
## 표준
- 개발주석표준
- 설명: 개발 주석 표준
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/standards/standard_comment.md
- 파일명: standard_comment.md
- 패키지구조표준
- 설명: 패키지 구조 표준과 설계 아키텍처 패턴(Layered, Clean, Hexagonal)별 예시
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/standards/standard_package_structure.md
- 파일명: standard_package_structure.md
- 테스트코드표준
- 설명: 테스트 코드 작성 표준
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/standards/standard_testcode.md
- 파일명: standard_testcode.md
---
## 기술 도구
- PlantUML문법검사가이드
- 설명: PlantUML 문법 검사하는 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/plantuml-guide.md
- 파일명: plantuml-guide.md
- Mermaid문법검사가이드
- 설명: Mermaid 문법 검사하는 방법 안내
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/mermaid-guide.md
- 파일명: mermaid-guide.md
- MCP동기화도구
- 설명: Window에서 Cloude Desktop의 MCP설정을 읽어 Claude Code에 MCP 서버를 동기화하는 툴
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/sync-mcp.md
- 파일명: sync-mcp.md
- PlantUML문법검사기(Window)
- 설명: Window용 PlantUML 스크립트 문법 검사기
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/check-plantuml.ps1
- 파일명: check-plantuml.ps1
- Mermaid문법검사기(Window)
- 설명: Window용 PlantUML 스크립트 문법 검사기
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/check-mermaid.ps1
- 파일명: check-mermaid.ps1
- PlantUML문법검사기(Linux/Mac)
- 설명: Linux/Mac용 PlantUML 스크립트 문법 검사기
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/check-plantuml.sh
- 파일명: check-plantuml.sh
- Mermaid문법검사기(Linux/Mac)
- 설명: Linux/Mac용 PlantUML 스크립트 문법 검사기
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/check-mermaid.sh
- 파일명: check-mermaid.sh
- IntelliJ서비스실행기
- 설명: IntelliJ에 등록된 실행프로파일을 이용하여 서비스 실행
- URL: https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/tools/run-intellij-service-profile.py
- 파일명: run-intellij-service-profile.py
---
## 산출물 디렉토리
- 유저스토리: design/userstory.md
- UI/UX설계서: design/uiux/uiux.md
- 스타일가이드: design/uiux/style-guide.md
- 프로토타입: design/uiux/prototype/*.html
- 아키텍처패턴: design/pattern/architecture-pattern.md
- 논리아키텍처: design/backend/logical/*
- API설계서: design/backend/api/*
- API명세서: design/backend/api/spec/*
- 외부시퀀스설계서: design/backend/sequence/outer/{플로우명}.puml
- 내부시퀀스설계서: design/backend/sequence/inner/{service-name}-{flow-name}.puml
- 클래스설계서: design/backend/class/*
- 백엔드패키지구조도: 클래스설계 결과(design/backend/class/class.md)의 '패키지 구조도' 섹션
- 데이터설계서: design/backend/database/*
- HighLevel아키텍처정의서: design/high-level-architecture.md
- 물리아키텍처: design/backend/physical/*
- 데이터베이스설치계획서
- develop/database/plan/db-plan-{service-name}-dev.md
- develop/database/plan/db-plan-{service-name}-prod.md
- 캐시설치계획서:
- develop/mq/mq-plan-dev.md
- develop/mq/mq-plan-prod.md
- MQ설치계획서
- develop/database/plan/mq-plan-{service-name}-dev.md
- develop/database/plan/mq-plan-{service-name}-prod.md
- 데이터베이스설치결과서
- develop/database/exec/db-exec-dev.md
- develop/database/exec/db-exec-prod.md
- 캐시설치결과서
- develop/database/exec/cache-exec-{service-name}-dev.md
- develop/database/exec/cache-exec-{service-name}-prod.md
- MQ설치결과서
- develop/mq/mq-exec-dev.md
- develop/mq/mq-exec-prod.md
- 백엔드개발결과서: develop/dev/dev-backend.md
- 백엔드테스트결과서: develop/dev/test-backend.md
- 프론트엔드설계서: design/frontend/frontend-design.md
## 프롬프트 약어
### 역할 약어
- "@archi": "--persona-architect"
- "@front": "--persona-front"
- "@back": "--persona-backend"
- "@secu": "--persona-security"
- "@qa": "--persona-qa"
- "@refact": "--persona-refactor"
- "@devops": "--persona-devops"
- "@scribe": "--persona-scriber"
### 작업 약어
- "@complex-flag": --seq --c7 --uc --wave-mode auto --wave-strategy systematic --delegate auto
- "@userstory": /sc:document @scribe @archi --think --wave-strategy systematic
- "@uiux": /sc:design --think @front --uc --wave-mode auto --wave-strategy systematic
- "@prototype": /sc:implement @front --answer-only
- "@design-pattern": /sc:design @archi --think-hard @complex-flag
- "@architecture": /sc:design @archi @back @refact --think-hard @complex-flag
- "@plan": --plan --think
- "@backing-service": /sc:implement @devops @back --think-hard @complex-flag
- "@dev-backend": /sc:implement @back --think-hard @complex-flag
- "@dev-front": /sc:implement @front --think-hard @complex-flag
- "@test-backend": /sc:test @back @qa --think @complex-flag
- "@test-api": /sc:test @back @qa --think 1) 소스 수정 후 컴파일하고 서버 시작 요청. 2) API경로와 DTO를 분석하여 정확하게 요청하여 테스트
- "@run-back":
- 'IntelliJ서비스실행기'를 'tools' 디렉토리에 다운로드
- python 또는 python3 명령으로 백그라우드로 실행하고 결과 로그를 분석
nohup python3 tools/run-intellij-service-profile.py {service-name} > logs/{service-name}.log 2>&1 & echo "Started {service-name} with PID: $!"
- "@test-front": /sc:test @front @qa --play --think @complex-flag
- "@cicd": /sc:implement @devops --think @complex-flag
- "@document": /sc:document --think @scribe @complex-flag
- "@fix": /sc:troubleshoot --think @complex-flag
- "@estimate": /sc:estimate --think-hard @complex-flag
- "@improve": /sc:improve --think @complex-flag
- "@analyze": /sc:analyze --think --seq
- "@explain": /sc:explain --think --seq --answer-only
### 파일 약어
- "@error": debug/error.png파일을 의미함
- "@info": debug/info.png파일을 의미함
### 작업 단계 가이드 약어
- "@think-help": "기획실행프롬프트 내용을 터미널에 출력"
- "@design-help": "설계실행프롬프트 내용을 터미널에 출력"
- "@develop-help": "개발실행프롬프트 내용을 터미널에 출력"
- "@deploy-help": "배포실행프롬프트 내용을 터미널에 출력"
``` ```

View File

@ -12,10 +12,10 @@
<entry key="DB_MAX_LIFETIME" value="1800000" /> <entry key="DB_MAX_LIFETIME" value="1800000" />
<entry key="DB_MAX_POOL" value="20" /> <entry key="DB_MAX_POOL" value="20" />
<entry key="DB_MIN_IDLE" value="5" /> <entry key="DB_MIN_IDLE" value="5" />
<entry key="DB_NAME" value="bill_inquiry_db" /> <entry key="DB_NAME" value="inquirydb" />
<entry key="DB_PASSWORD" value="BillUser2025@" /> <entry key="DB_PASSWORD" value="P@ssw0rd$" />
<entry key="DB_PORT" value="25432" /> <entry key="DB_PORT" value="25432" />
<entry key="DB_USERNAME" value="bill_inquiry_user" /> <entry key="DB_USERNAME" value="unicorn" />
<entry key="JWT_ACCESS_TOKEN_VALIDITY" value="18000000" /> <entry key="JWT_ACCESS_TOKEN_VALIDITY" value="18000000" />
<entry key="JWT_REFRESH_TOKEN_VALIDITY" value="86400000" /> <entry key="JWT_REFRESH_TOKEN_VALIDITY" value="86400000" />
<entry key="JWT_SECRET" value="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" /> <entry key="JWT_SECRET" value="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" />
@ -27,8 +27,8 @@
<entry key="REDIS_MAX_IDLE" value="8" /> <entry key="REDIS_MAX_IDLE" value="8" />
<entry key="REDIS_MAX_WAIT" value="-1" /> <entry key="REDIS_MAX_WAIT" value="-1" />
<entry key="REDIS_MIN_IDLE" value="0" /> <entry key="REDIS_MIN_IDLE" value="0" />
<entry key="REDIS_PASSWORD" value="Redis2025Dev@" /> <entry key="REDIS_PASSWORD" value="P@ssw0rd$" />
<entry key="REDIS_PORT" value="6379" /> <entry key="REDIS_PORT" value="16379" />
<entry key="REDIS_TIMEOUT" value="2000" /> <entry key="REDIS_TIMEOUT" value="2000" />
<entry key="SERVER_PORT" value="8082" /> <entry key="SERVER_PORT" value="8082" />
<entry key="SPRING_PROFILES_ACTIVE" value="dev" /> <entry key="SPRING_PROFILES_ACTIVE" value="dev" />

View File

@ -25,9 +25,11 @@ spring:
leak-detection-threshold: 60000 leak-detection-threshold: 60000
# JPA 설정 # JPA 설정
jpa: jpa:
database-platform: org.hibernate.dialect.PostgreSQLDialect
show-sql: ${SHOW_SQL:true} show-sql: ${SHOW_SQL:true}
properties: properties:
hibernate: hibernate:
dialect: org.hibernate.dialect.PostgreSQLDialect
format_sql: true format_sql: true
use_sql_comments: true use_sql_comments: true
connection: connection:

View File

@ -7,21 +7,17 @@ def getImageTag() {
} }
podTemplate( podTemplate(
cloud: 'k8s',
label: "${PIPELINE_ID}", label: "${PIPELINE_ID}",
serviceAccount: 'jenkins', serviceAccount: 'jenkins',
slaveConnectTimeout: 300, slaveConnectTimeout: 300,
idleMinutes: 1, idleMinutes: 1,
activeDeadlineSeconds: 3600, activeDeadlineSeconds: 3600,
podRetention: never(), // 파드 자동 정리 옵션: never(), onFailure(), always(), default() podRetention: never(),
yaml: ''' yaml: '''
spec: spec:
terminationGracePeriodSeconds: 3 terminationGracePeriodSeconds: 3
restartPolicy: Never restartPolicy: Never
tolerations:
- effect: NoSchedule
key: dedicated
operator: Equal
value: cicd
''', ''',
containers: [ containers: [
containerTemplate( containerTemplate(
@ -51,7 +47,7 @@ podTemplate(
] ]
), ),
containerTemplate( containerTemplate(
name: 'azure-cli', name: 'kubectl',
image: 'hiondal/azure-kubectl:latest', image: 'hiondal/azure-kubectl:latest',
command: 'cat', command: 'cat',
ttyEnabled: true, ttyEnabled: true,
@ -69,10 +65,9 @@ podTemplate(
) { ) {
node(PIPELINE_ID) { node(PIPELINE_ID) {
def props def props
//def imageTag = getImageTag() def imageTag = getImageTag()
def imageTag = "dg0500"
def environment = params.ENVIRONMENT ?: 'dev' def environment = params.ENVIRONMENT ?: 'dev'
def skipSonarQube = (params.SKIP_SONARQUBE?.toLowerCase() == 'true') def skipSonarQube = params.SKIP_SONARQUBE ?: 'true'
def services = ['api-gateway', 'user-service', 'bill-service', 'product-service', 'kos-mock'] def services = ['api-gateway', 'user-service', 'bill-service', 'product-service', 'kos-mock']
try { try {
@ -81,15 +76,11 @@ podTemplate(
props = readProperties file: "deployment/cicd/config/deploy_env_vars_${environment}" props = readProperties file: "deployment/cicd/config/deploy_env_vars_${environment}"
} }
stage("Setup AKS") { stage("Setup Kubernetes2") {
container('azure-cli') { container('kubectl') {
withCredentials([azureServicePrincipal('azure-credentials')]) { sh """
sh """ kubectl create namespace ${props.namespace} --dry-run=client -o yaml | kubectl apply -f -
az login --service-principal -u \$AZURE_CLIENT_ID -p \$AZURE_CLIENT_SECRET -t \$AZURE_TENANT_ID
az aks get-credentials --resource-group ${props.resource_group} --name ${props.cluster_name} --overwrite-existing
kubectl create namespace phonebill-dg0500 --dry-run=client -o yaml | kubectl apply -f -
""" """
}
} }
} }
@ -107,27 +98,37 @@ podTemplate(
echo "⏭️ Skipping SonarQube Analysis (SKIP_SONARQUBE=${params.SKIP_SONARQUBE})" echo "⏭️ Skipping SonarQube Analysis (SKIP_SONARQUBE=${params.SKIP_SONARQUBE})"
} else { } else {
container('gradle') { container('gradle') {
withSonarQubeEnv('SonarQube') { // 각 서비스별로 개별적으로 SonarQube 분석 및 Quality Gate 확인
// 각 서비스별 테스트 및 SonarQube 분석 services.each { service ->
services.each { service -> withSonarQubeEnv('SonarQube') {
echo "🔍 Starting SonarQube analysis for ${service}..."
// 서비스별 테스트 및 SonarQube 분석
sh """ sh """
./gradlew :${service}:test :${service}:jacocoTestReport :${service}:sonar \\ ./gradlew :${service}:test :${service}:jacocoTestReport :${service}:sonar \
-Dsonar.projectKey=phonebill-${service}-dg0500 \\ -Dsonar.projectKey=phonebill-${service}-${environment} \
-Dsonar.projectName=phonebill-${service}-dg0500 \\ -Dsonar.projectName=phonebill-${service}-${environment} \
-Dsonar.java.binaries=build/classes/java/main \\ -Dsonar.java.binaries=build/classes/java/main \
-Dsonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/test/jacocoTestReport.xml \\ -Dsonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/test/jacocoTestReport.xml \
-Dsonar.exclusions=**/config/**,**/entity/**,**/dto/**,**/*Application.class,**/exception/** -Dsonar.exclusions=**/config/**,**/entity/**,**/dto/**,**/*Application.class,**/exception/**
""" """
echo "✅ SonarQube analysis completed for ${service}"
} }
// Quality Gate 확인 // 각 서비스별 Quality Gate 확인
timeout(time: 10, unit: 'MINUTES') { timeout(time: 5, unit: 'MINUTES') {
echo "⏳ Waiting for Quality Gate result for ${service}..."
def qg = waitForQualityGate() def qg = waitForQualityGate()
if (qg.status != 'OK') { if (qg.status != 'OK') {
error "Pipeline aborted due to quality gate failure: ${qg.status}" error "❌ Quality Gate failed for ${service}: ${qg.status}"
} else {
echo "✅ Quality Gate passed for ${service}"
} }
} }
} }
echo "🎉 All services passed SonarQube Quality Gates!"
} }
} }
} }
@ -137,9 +138,9 @@ podTemplate(
container('podman') { container('podman') {
withCredentials([ withCredentials([
usernamePassword( usernamePassword(
credentialsId: 'acr-credentials', credentialsId: 'imagereg-credentials',
usernameVariable: 'ACR_USERNAME', usernameVariable: 'IMG_USERNAME',
passwordVariable: 'ACR_PASSWORD' passwordVariable: 'IMG_PASSWORD'
), ),
usernamePassword( usernamePassword(
credentialsId: 'dockerhub-credentials', credentialsId: 'dockerhub-credentials',
@ -150,18 +151,18 @@ podTemplate(
// Docker Hub 로그인 (rate limit 해결) // Docker Hub 로그인 (rate limit 해결)
sh "podman login docker.io --username \$DOCKERHUB_USERNAME --password \$DOCKERHUB_PASSWORD" sh "podman login docker.io --username \$DOCKERHUB_USERNAME --password \$DOCKERHUB_PASSWORD"
// ACR 로그인 // Image Registry 로그인
sh "podman login acrdigitalgarage01.azurecr.io --username \$ACR_USERNAME --password \$ACR_PASSWORD" sh "podman login docker.io --username \$IMG_USERNAME --password \$IMG_PASSWORD"
services.each { service -> services.each { service ->
sh """ sh """
podman build \\ podman build \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \\ --build-arg BUILD_LIB_DIR="${service}/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \\ --build-arg ARTIFACTORY_FILE="${service}.jar" \
-f deployment/container/Dockerfile-backend \\ -f deployment/container/Dockerfile-backend \
-t acrdigitalgarage01.azurecr.io/phonebill/${service}:${environment}-${imageTag} . -t docker.io/hiondal/${service}:${environment}-${imageTag} .
podman push acrdigitalgarage01.azurecr.io/phonebill/${service}:${environment}-${imageTag} podman push docker.io/hiondal/${service}:${environment}-${imageTag}
""" """
} }
} }
@ -170,7 +171,8 @@ podTemplate(
} }
stage('Update Kustomize & Deploy') { stage('Update Kustomize & Deploy') {
container('azure-cli') { container('kubectl') {
def namespace = props.namespace
sh """ sh """
# Kustomize 설치 (sudo 없이 사용자 디렉토리에 설치) # Kustomize 설치 (sudo 없이 사용자 디렉토리에 설치)
curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh" | bash curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh" | bash
@ -181,12 +183,12 @@ podTemplate(
# 환경별 디렉토리로 이동 # 환경별 디렉토리로 이동
cd deployment/cicd/kustomize/overlays/${environment} cd deployment/cicd/kustomize/overlays/${environment}
# 서비스 목록 정의 (실제 서비스명으로 교체, 공백으로 구분) # 서비스 목록 정의 (공백으로 구분)
services="api-gateway user-service bill-service product-service kos-mock" services="api-gateway user-service bill-service product-service kos-mock"
# 이미지 태그 업데이트 # 이미지 태그 업데이트
for service in \$services; do for service in \$services; do
\$HOME/bin/kustomize edit set image acrdigitalgarage01.azurecr.io/phonebill/\$service:${environment}-${imageTag} \$HOME/bin/kustomize edit set image docker.io/hiondal/\$service=docker.io/hiondal/\$service:${environment}-${imageTag}
done done
# 매니페스트 적용 # 매니페스트 적용
@ -195,7 +197,7 @@ podTemplate(
# 배포 상태 확인 # 배포 상태 확인
echo "Waiting for deployments to be ready..." echo "Waiting for deployments to be ready..."
for service in \$services; do for service in \$services; do
kubectl -n phonebill-dg0500 wait --for=condition=available deployment/\$service --timeout=300s kubectl -n ${namespace} wait --for=condition=available deployment/\$service --timeout=300s
done done
""" """
} }
@ -222,4 +224,4 @@ podTemplate(
echo "Pod will be terminated in 3 seconds due to terminationGracePeriodSeconds: 3" echo "Pod will be terminated in 3 seconds due to terminationGracePeriodSeconds: 3"
} }
} }
} }

View File

@ -1,240 +0,0 @@
def PIPELINE_ID = "${env.BUILD_NUMBER}"
def getImageTag() {
def dateFormat = new java.text.SimpleDateFormat('yyyyMMddHHmmss')
def currentDate = new Date()
return dateFormat.format(currentDate)
}
podTemplate(
label: "${PIPELINE_ID}",
serviceAccount: 'jenkins',
slaveConnectTimeout: 300,
idleMinutes: 1,
activeDeadlineSeconds: 3600,
podRetention: never(), // 파드 자동 정리 옵션: never(), onFailure(), always(), default()
yaml: '''
spec:
terminationGracePeriodSeconds: 3
restartPolicy: Never
tolerations:
- effect: NoSchedule
key: dedicated
operator: Equal
value: cicd
''',
containers: [
containerTemplate(
name: 'podman',
image: "mgoltzsche/podman",
ttyEnabled: true,
command: 'cat',
privileged: true,
resourceRequestCpu: '500m',
resourceRequestMemory: '2Gi',
resourceLimitCpu: '2000m',
resourceLimitMemory: '4Gi'
),
containerTemplate(
name: 'gradle',
image: 'gradle:jdk21',
ttyEnabled: true,
command: 'cat',
resourceRequestCpu: '500m',
resourceRequestMemory: '1Gi',
resourceLimitCpu: '1000m',
resourceLimitMemory: '2Gi',
envVars: [
envVar(key: 'DOCKER_HOST', value: 'unix:///run/podman/podman.sock'),
envVar(key: 'TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE', value: '/run/podman/podman.sock'),
envVar(key: 'TESTCONTAINERS_RYUK_DISABLED', value: 'true')
]
),
containerTemplate(
name: 'azure-cli',
image: 'hiondal/azure-kubectl:latest',
command: 'cat',
ttyEnabled: true,
resourceRequestCpu: '200m',
resourceRequestMemory: '512Mi',
resourceLimitCpu: '500m',
resourceLimitMemory: '1Gi'
),
containerTemplate(
name: 'git',
image: 'alpine/git:latest',
command: 'cat',
ttyEnabled: true,
resourceRequestCpu: '100m',
resourceRequestMemory: '256Mi',
resourceLimitCpu: '300m',
resourceLimitMemory: '512Mi'
)
],
volumes: [
emptyDirVolume(mountPath: '/home/gradle/.gradle', memory: false),
emptyDirVolume(mountPath: '/root/.azure', memory: false),
emptyDirVolume(mountPath: '/run/podman', memory: false)
]
) {
node(PIPELINE_ID) {
def props
def imageTag = "dg0500-"+getImageTag()
def environment = params.ENVIRONMENT ?: 'dev'
def skipSonarQube = (params.SKIP_SONARQUBE?.toLowerCase() == 'true')
def services = ['api-gateway', 'user-service', 'bill-service', 'product-service', 'kos-mock']
try {
stage("Get Source") {
checkout scm
props = readProperties file: "deployment/cicd/config/deploy_env_vars_${environment}"
}
stage('Build') {
container('gradle') {
sh """
chmod +x gradlew
./gradlew build -x test
"""
}
}
stage('SonarQube Analysis & Quality Gate') {
if (skipSonarQube) {
echo "⏭️ Skipping SonarQube Analysis (SKIP_SONARQUBE=${params.SKIP_SONARQUBE})"
} else {
container('gradle') {
// 각 서비스별로 개별적으로 SonarQube 분석 및 Quality Gate 확인
services.each { service ->
withSonarQubeEnv('SonarQube') {
echo "🔍 Starting SonarQube analysis for ${service}..."
// 서비스별 테스트 및 SonarQube 분석
sh """
./gradlew :${service}:test :${service}:jacocoTestReport :${service}:sonar \\
-Dsonar.projectKey=phonebill-${service}-dg0500 \\
-Dsonar.projectName=phonebill-${service}-dg0500 \\
-Dsonar.java.binaries=build/classes/java/main \\
-Dsonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/test/jacocoTestReport.xml \\
-Dsonar.exclusions=**/config/**,**/entity/**,**/dto/**,**/*Application.class,**/exception/**
"""
echo "✅ SonarQube analysis completed for ${service}"
}
// 각 서비스별 Quality Gate 확인
timeout(time: 5, unit: 'MINUTES') {
echo "⏳ Waiting for Quality Gate result for ${service}..."
def qg = waitForQualityGate()
if (qg.status != 'OK') {
error "❌ Quality Gate failed for ${service}: ${qg.status}"
} else {
echo "✅ Quality Gate passed for ${service}"
}
}
}
echo "🎉 All services passed SonarQube Quality Gates!"
}
}
}
stage('Build & Push Images') {
timeout(time: 30, unit: 'MINUTES') {
container('podman') {
withCredentials([
usernamePassword(
credentialsId: 'acr-credentials',
usernameVariable: 'ACR_USERNAME',
passwordVariable: 'ACR_PASSWORD'
),
usernamePassword(
credentialsId: 'dockerhub-credentials',
usernameVariable: 'DOCKERHUB_USERNAME',
passwordVariable: 'DOCKERHUB_PASSWORD'
)
]) {
// Docker Hub 로그인 (rate limit 해결)
sh "podman login docker.io --username \$DOCKERHUB_USERNAME --password \$DOCKERHUB_PASSWORD"
// ACR 로그인
sh "podman login acrdigitalgarage01.azurecr.io --username \$ACR_USERNAME --password \$ACR_PASSWORD"
services.each { service ->
sh """
podman build \\
--build-arg BUILD_LIB_DIR="${service}/build/libs" \\
--build-arg ARTIFACTORY_FILE="${service}.jar" \\
-f deployment/container/Dockerfile-backend \\
-t acrdigitalgarage01.azurecr.io/phonebill/${service}:${environment}-${imageTag} .
podman push acrdigitalgarage01.azurecr.io/phonebill/${service}:${environment}-${imageTag}
"""
}
}
}
}
}
stage('Update Manifest Repository') {
container('git') {
withCredentials([usernamePassword(
credentialsId: 'github-credentials-dg0500',
usernameVariable: 'GIT_USERNAME',
passwordVariable: 'GIT_TOKEN'
)]) {
sh """
# 매니페스트 레포지토리 클론
REPO_URL=\$(echo "https://github.com/cna-bootcamp/phonebill-manifest.git" | sed 's|https://||')
git clone https://\${GIT_USERNAME}:\${GIT_TOKEN}@\${REPO_URL} manifest-repo
cd manifest-repo
# 각 서비스별 이미지 태그 업데이트 (sed 명령 사용)
services="api-gateway user-service bill-service product-service kos-mock"
for service in \$services; do
echo "Updating \$service image tag..."
sed -i "s|image: acrdigitalgarage01.azurecr.io/phonebill/\$service:.*|image: acrdigitalgarage01.azurecr.io/phonebill/\$service:${environment}-${imageTag}|g" \\
phonebill/kustomize/base/\$service/deployment.yaml
# 변경 사항 확인
echo "Updated \$service deployment.yaml:"
grep "image: acrdigitalgarage01.azurecr.io/phonebill/\$service" phonebill/kustomize/base/\$service/deployment.yaml
done
# Git 설정 및 푸시
git config user.name "Jenkins CI"
git config user.email "jenkins@example.com"
git add .
git commit -m "🚀 Update phonebill ${environment} images to ${environment}-${imageTag}"
git push origin main
echo "✅ 매니페스트 업데이트 완료. ArgoCD가 자동으로 배포합니다."
"""
}
}
}
// 파이프라인 완료 로그 (Scripted Pipeline 방식)
stage('Pipeline Complete') {
echo "🧹 Pipeline completed. Pod cleanup handled by Jenkins Kubernetes Plugin."
// 성공/실패 여부 로깅
if (currentBuild.result == null || currentBuild.result == 'SUCCESS') {
echo "✅ Pipeline completed successfully!"
} else {
echo "❌ Pipeline failed with result: ${currentBuild.result}"
}
}
} catch (Exception e) {
currentBuild.result = 'FAILURE'
echo "❌ Pipeline failed with exception: ${e.getMessage()}"
throw e
} finally {
echo "🧹 Cleaning up resources and preparing for pod termination..."
echo "Pod will be terminated in 3 seconds due to terminationGracePeriodSeconds: 3"
}
}
}

View File

@ -1,3 +1,2 @@
# dev Environment Configuration # dev Environment Configuration
resource_group=rg-digitalgarage-01 namespace=phonebill
cluster_name=aks-digitalgarage-01

View File

@ -1,3 +1,3 @@
# prod Environment Configuration # prod Environment Configuration
resource_group=rg-digitalgarage-01 context=minikube-prod
cluster_name=aks-digitalgarage-01 namespace=phonebill

View File

@ -1,3 +1,3 @@
# staging Environment Configuration # staging Environment Configuration
resource_group=rg-digitalgarage-01 context=minikube-staging
cluster_name=aks-digitalgarage-01 namespace=phonebill

View File

@ -1,43 +1,27 @@
# phonebill Jenkins CI/CD 파이프라인 구축 가이드 # 백엔드 Jenkins CI/CD 파이프라인 가이드
## 📋 개요 ## 📋 개요
본 가이드는 phonebill 프로젝트를 위한 Jenkins + Kustomize 기반 CI/CD 파이프라인 구축 방법을 제공합니다. 이 가이드는 phonebill 프로젝트의 Jenkins + Kustomize 기반 CI/CD 파이프라인 구축 및 운영 방법을 설명합니다.
## 🔧 사전 준비사항
### 프로젝트 정보 ### 프로젝트 정보
- **시스템명**: phonebill | 항목 | 값 |
- **서비스 목록**: api-gateway, user-service, bill-service, product-service, kos-mock |------|-----|
- **JDK 버전**: 21 | 시스템명 | phonebill |
- **Azure 환경**: | 서비스 목록 | api-gateway, user-service, bill-service, product-service, kos-mock |
- ACR: acrdigitalgarage01 | JDK 버전 | 21 |
- 리소스 그룹: rg-digitalgarage-01 | Image Registry | docker.io |
- AKS 클러스터: aks-digitalgarage-01 | Image Organization | hiondal |
- 네임스페이스: phonebill-dg0500 | Jenkins K8s Cloud Name | k8s |
| K8s Context Prefix | minikube |
| Namespace | phonebill |
## 🏗️ 파이프라인 아키텍처 ### Jenkins 서버 환경 구성
### 주요 구성 요소 #### 1. 필수 플러그인 설치
- **빌드**: Gradle 기반 멀티모듈 빌드 ```
- **품질 검증**: SonarQube 분석 & Quality Gate
- **컨테이너화**: Podman 기반 이미지 빌드
- **배포**: Kustomize를 통한 환경별 배포
- **인프라**: AKS (Azure Kubernetes Service)
### 환경별 설정
| 환경 | Replicas | CPU Request | Memory Request | CPU Limit | Memory Limit |
|------|----------|-------------|----------------|-----------|--------------|
| dev | 1 | 256m | 256Mi | 1024m | 1024Mi |
| staging | 2 | 512m | 512Mi | 2048m | 2048Mi |
| prod | 3 | 1024m | 1024Mi | 4096m | 4096Mi |
## 🚀 Jenkins 서버 환경 구성
### 1. Jenkins 필수 플러그인 설치
Jenkins 관리 > Plugin Manager에서 다음 플러그인들을 설치해주세요:
```bash
# Jenkins 필수 플러그인 목록
- Kubernetes - Kubernetes
- Pipeline Utility Steps - Pipeline Utility Steps
- Docker Pipeline - Docker Pipeline
@ -46,136 +30,135 @@ Jenkins 관리 > Plugin Manager에서 다음 플러그인들을 설치해주세
- Azure Credentials - Azure Credentials
``` ```
### 2. Jenkins Credentials 등록 #### 2. Jenkins Credentials 등록
**Manage Jenkins > Credentials > Add Credentials**에서 다음 인증 정보들을 등록해주세요: **Docker Hub Credentials (Rate Limit 해결용)**
#### Azure Service Principal
``` ```
Kind: Microsoft Azure Service Principal - Kind: Username with password
ID: azure-credentials - ID: dockerhub-credentials
Subscription ID: {구독ID} - Username: {DOCKERHUB_USERNAME}
Client ID: {클라이언트ID} - Password: {DOCKERHUB_PASSWORD}
Client Secret: {클라이언트시크릿} - 참고: Docker Hub 무료 계정 생성 (https://hub.docker.com)
Tenant ID: {테넌트ID}
Azure Environment: Azure
``` ```
#### ACR Credentials **Image Registry Credentials**
``` ```
Kind: Username with password - Kind: Username with password
ID: acr-credentials - ID: imagereg-credentials
Username: acrdigitalgarage01 - Username: {REGISTRY_USERNAME}
Password: {ACR_PASSWORD} - Password: {REGISTRY_PASSWORD}
``` ```
#### Docker Hub Credentials (Rate Limit 해결용) **SonarQube Token (선택사항)**
``` ```
Kind: Username with password - Kind: Secret text
ID: dockerhub-credentials - ID: sonarqube-token
Username: {DOCKERHUB_USERNAME} - Secret: {SonarQube토큰}
Password: {DOCKERHUB_PASSWORD}
참고: Docker Hub 무료 계정 생성 (https://hub.docker.com)
``` ```
#### SonarQube Token ## 📁 디렉토리 구조
```
Kind: Secret text
ID: sonarqube-token
Secret: {SonarQube토큰}
```
## 📂 Kustomize 구조
``` ```
deployment/cicd/kustomize/ deployment/cicd/
├── base/ ├── Jenkinsfile # Jenkins 파이프라인 정의
│ ├── kustomization.yaml # Base 설정 ├── jenkins-pipeline-guide.md # 이 가이드 문서
│ ├── common/ # 공통 리소스 ├── config/
│ │ ├── cm-common.yaml │ ├── deploy_env_vars_dev # dev 환경 설정
│ │ ├── secret-common.yaml │ ├── deploy_env_vars_staging # staging 환경 설정
│ │ ├── secret-imagepull.yaml │ └── deploy_env_vars_prod # prod 환경 설정
│ │ └── ingress.yaml ├── scripts/
│ ├── api-gateway/ # API Gateway 리소스 │ ├── deploy.sh # 수동 배포 스크립트
│ │ ├── deployment.yaml │ └── validate-resources.sh # 리소스 검증 스크립트
│ │ ├── service.yaml └── kustomize/
│ │ └── cm-api-gateway.yaml ├── base/ # 기본 Kubernetes 매니페스트
│ ├── user-service/ # User Service 리소스
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-user-service.yaml
│ │ └── secret-user-service.yaml
│ ├── bill-service/ # Bill Service 리소스
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-bill-service.yaml
│ │ └── secret-bill-service.yaml
│ ├── product-service/ # Product Service 리소스
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-product-service.yaml
│ │ └── secret-product-service.yaml
│ └── kos-mock/ # KOS Mock 리소스
│ ├── deployment.yaml
│ ├── service.yaml
│ └── cm-kos-mock.yaml
└── overlays/
├── dev/ # 개발 환경
│ ├── kustomization.yaml │ ├── kustomization.yaml
│ ├── cm-common-patch.yaml │ ├── common/
│ ├── secret-common-patch.yaml │ │ ├── cm-common.yaml
│ ├── ingress-patch.yaml │ │ ├── secret-common.yaml
│ ├── deployment-*-patch.yaml (각 서비스별) │ │ └── ingress.yaml
│ └── secret-*-patch.yaml (Secret 보유 서비스) │ ├── api-gateway/
├── staging/ # 스테이징 환경 │ │ ├── deployment.yaml
│ └── (dev와 동일한 구조) │ │ ├── service.yaml
└── prod/ # 운영 환경 │ │ └── cm-api-gateway.yaml
└── (dev와 동일한 구조) │ ├── user-service/
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-user-service.yaml
│ │ └── secret-user-service.yaml
│ ├── bill-service/
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-bill-service.yaml
│ │ └── secret-bill-service.yaml
│ ├── product-service/
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ │ ├── cm-product-service.yaml
│ │ └── secret-product-service.yaml
│ └── kos-mock/
│ ├── deployment.yaml
│ ├── service.yaml
│ └── cm-kos-mock.yaml
└── overlays/
├── dev/ # 개발 환경 오버레이
├── staging/ # 스테이징 환경 오버레이
└── prod/ # 운영 환경 오버레이
``` ```
## 🔧 Jenkins Pipeline Job 생성 ## 🚀 Jenkins Pipeline Job 생성
### 1. 새 Pipeline Job 생성 ### 1. Pipeline Job 생성
1. Jenkins 대시보드에서 **New Item** 클릭 1. Jenkins 웹 UI에서 **New Item** > **Pipeline** 선택
2. **Pipeline** 선택하고 프로젝트명 입력 2. Pipeline script from SCM 설정:
3. **OK** 클릭 ```
SCM: Git
Repository URL: {Git저장소URL}
Branch: main (또는 develop)
Script Path: deployment/cicd/Jenkinsfile
```
### 2. Pipeline 설정 ### 2. Pipeline Parameters 설정
#### General 탭 | 파라미터 | 타입 | 값 | 설명 |
- **Build Parameters** 추가: |---------|------|-----|------|
``` | ENVIRONMENT | Choice | dev, staging, prod | 배포 대상 환경 |
ENVIRONMENT: Choice Parameter | IMAGE_TAG | String | latest | 이미지 태그 (선택) |
Choices: dev, staging, prod | SKIP_SONARQUBE | String | true | SonarQube 분석 건너뛰기 |
Default: dev
IMAGE_TAG: String Parameter ## ⚙️ 환경별 설정
Default: latest
Description: 이미지 태그 (기본값: latest)
SKIP_SONARQUBE: String Parameter ### DEV 환경
Default: true ```yaml
Description: SonarQube 분석 건너뛰기 (true/false) # Replicas: 1
``` # Resources:
# requests: 256m CPU, 256Mi Memory
#### Pipeline 탭 # limits: 1024m CPU, 1024Mi Memory
``` # DDL_AUTO: update
Definition: Pipeline script from SCM # HTTPS: 비활성화
SCM: Git
Repository URL: {Git저장소URL}
Branch: main (또는 develop)
Script Path: deployment/cicd/Jenkinsfile
``` ```
## 📊 SonarQube 프로젝트 설정 ### STAGING 환경
```yaml
# Replicas: 2
# Resources:
# requests: 512m CPU, 512Mi Memory
# limits: 2048m CPU, 2048Mi Memory
# DDL_AUTO: validate
# HTTPS: 활성화 (SSL 인증서 필요)
```
### 1. 각 서비스별 SonarQube 프로젝트 생성 ### PROD 환경
- phonebill-api-gateway-{환경} ```yaml
- phonebill-user-service-{환경} # Replicas: 3
- phonebill-bill-service-{환경} # Resources:
- phonebill-product-service-{환경} # requests: 1024m CPU, 1024Mi Memory
- phonebill-kos-mock-{환경} # limits: 4096m CPU, 4096Mi Memory
# DDL_AUTO: validate
# HTTPS: 활성화 (SSL 인증서 필요)
```
### 2. Quality Gate 설정 ## 📊 SonarQube 설정
### Quality Gate 설정
``` ```
Coverage: >= 80% Coverage: >= 80%
Duplicated Lines: <= 3% Duplicated Lines: <= 3%
@ -184,194 +167,123 @@ Reliability Rating: <= A
Security Rating: <= A Security Rating: <= A
``` ```
## 🚀 배포 실행 방법 ### 분석 제외 대상
```
### 1. Jenkins Pipeline 실행 **/config/**
1. Jenkins > {프로젝트명} > **Build with Parameters** 클릭 **/entity/**
2. 파라미터 설정: **/dto/**
- **ENVIRONMENT**: dev/staging/prod 선택 **/*Application.class
- **IMAGE_TAG**: 이미지 태그 입력 (선택사항) **/exception/**
- **SKIP_SONARQUBE**: SonarQube 분석 건너뛰려면 "true", 실행하려면 "false"
3. **Build** 클릭
### 2. 수동 배포 (스크립트 사용)
```bash
# 개발 환경 배포
./deployment/cicd/scripts/deploy.sh dev 20241230120000
# 스테이징 환경 배포
./deployment/cicd/scripts/deploy.sh staging 20241230120000
# 운영 환경 배포
./deployment/cicd/scripts/deploy.sh prod 20241230120000
``` ```
### 3. 배포 상태 확인 ## 🔨 수동 배포
### 배포 스크립트 사용
```bash ```bash
# Pod 상태 확인 # dev 환경 배포
kubectl get pods -n phonebill-dg0500 ./deployment/cicd/scripts/deploy.sh dev latest
# 서비스 상태 확인 # staging 환경 배포
kubectl get services -n phonebill-dg0500 ./deployment/cicd/scripts/deploy.sh staging v1.0.0
# Ingress 상태 확인 # prod 환경 배포
kubectl get ingress -n phonebill-dg0500 ./deployment/cicd/scripts/deploy.sh prod v1.0.0
# 특정 서비스 로그 확인
kubectl logs -f deployment/user-service -n phonebill-dg0500
``` ```
## 🔍 리소스 검증 ### 리소스 검증
### 리소스 검증 스크립트 실행
```bash ```bash
# 모든 Kustomize 리소스 검증 # Kustomize 리소스 검증
./deployment/cicd/scripts/validate-resources.sh ./deployment/cicd/scripts/validate-resources.sh
``` ```
### 수동 검증 명령어 ## 🔄 배포 상태 확인
```bash
# Base 검증
kubectl kustomize deployment/cicd/kustomize/base/
# 환경별 검증 ```bash
kubectl kustomize deployment/cicd/kustomize/overlays/dev/ # 파드 상태 확인
kubectl kustomize deployment/cicd/kustomize/overlays/staging/ kubectl get pods -n phonebill
kubectl kustomize deployment/cicd/kustomize/overlays/prod/
# 서비스 상태 확인
kubectl get services -n phonebill
# 인그레스 확인
kubectl get ingress -n phonebill
# 배포 상태 상세 확인
kubectl describe deployment api-gateway -n phonebill
``` ```
## 🔄 롤백 방법 ## 롤백 방법
### 1. Kubernetes 롤백 ### 이전 버전으로 롤백
```bash ```bash
# 특정 버전으로 롤백 # 특정 리비전으로 롤백
kubectl rollout undo deployment/{서비스명} -n phonebill-dg0500 --to-revision=2 kubectl rollout undo deployment/{서비스명} -n phonebill --to-revision=2
# 롤백 상태 확인 # 롤백 상태 확인
kubectl rollout status deployment/{서비스명} -n phonebill-dg0500 kubectl rollout status deployment/{서비스명} -n phonebill
``` ```
### 2. 이미지 태그 기반 롤백 ### 이미지 태그 기반 롤백
```bash ```bash
# 이전 안정 버전 이미지 태그로 업데이트 # 이전 안정 버전 이미지 태그로 업데이트
cd deployment/cicd/kustomize/overlays/{환경} cd deployment/cicd/kustomize/overlays/{환경}
kustomize edit set image acrdigitalgarage01.azurecr.io/phonebill/{서비스명}:{환경}-{이전태그} kustomize edit set image docker.io/hiondal/{서비스명}=docker.io/hiondal/{서비스명}:{환경}-{이전태그}
kubectl apply -k . kubectl apply -k .
``` ```
## 🎯 파이프라인 단계별 설명 ## 🔍 문제 해결
### 1. Get Source ### 일반적인 문제
- Git 저장소에서 소스코드 체크아웃
- 환경별 설정 파일 로드
### 2. Setup AKS #### 1. 이미지 풀 실패
- Azure CLI를 통한 AKS 클러스터 연결
- 네임스페이스 생성 (phonebill-dg0500)
### 3. Build
- Gradle을 통한 멀티모듈 빌드
- 테스트는 SonarQube 단계에서 실행
### 4. SonarQube Analysis & Quality Gate
- 각 서비스별 개별 테스트 실행
- JaCoCo 코드 커버리지 리포트 생성
- SonarQube 정적 분석
- Quality Gate 통과 검증
### 5. Build & Push Images
- Podman을 통한 컨테이너 이미지 빌드
- 환경별 태그로 ACR에 푸시
- 30분 타임아웃 설정
### 6. Update Kustomize & Deploy
- Kustomize를 통한 이미지 태그 업데이트
- 환경별 매니페스트 적용
- 배포 완료까지 대기 (5분 타임아웃)
### 7. Pipeline Complete
- 파이프라인 완료 상태 로깅
- Pod 자동 정리 (3초 후 종료)
## ⚠️ 주의사항
### 1. 파드 자동 정리
- 파이프라인 완료 시 에이전트 파드 자동 삭제
- `podRetention: never()` 설정으로 즉시 정리
- 리소스 절약을 위한 필수 설정
### 2. 변수 참조 문법
- Jenkins Groovy에서는 `${variable}` 사용
- `\${variable}` 사용 시 "syntax error: bad substitution" 오류 발생
### 3. 쉘 호환성
- Jenkins 컨테이너 기본 쉘이 `/bin/sh`인 경우
- Bash 배열 문법 `()` 미지원으로 공백 구분 문자열 사용
### 4. 환경별 설정 차이점
- **DEV**: SSL 리다이렉트 비활성화, 기본 도메인 사용
- **STAGING/PROD**: SSL 리다이렉트 활성화, 사용자 정의 도메인, 인증서 설정
## 🛠️ 트러블슈팅
### 1. 빌드 실패
```bash ```bash
# Gradle 캐시 클리어 # ImagePullBackOff 상태 확인
./gradlew clean build kubectl describe pod {pod-name} -n phonebill
# JDK 버전 확인 # Docker Hub 인증 확인
java -version kubectl get secret -n phonebill
``` ```
### 2. 이미지 푸시 실패 #### 2. 파드 시작 실패
```bash ```bash
# ACR 로그 확인 # 로그 확인
az acr login --name acrdigitalgarage01 kubectl logs {pod-name} -n phonebill
# Docker Hub rate limit 확인 # 이벤트 확인
docker info | grep -i rate kubectl get events -n phonebill --sort-by='.lastTimestamp'
``` ```
### 3. 배포 실패 #### 3. Kustomize 빌드 실패
```bash ```bash
# 네임스페이스 확인 # 검증 스크립트 실행
kubectl get namespaces ./deployment/cicd/scripts/validate-resources.sh
# 리소스 상태 확인 # 직접 빌드 테스트
kubectl describe deployment/{서비스명} -n phonebill-dg0500 kubectl kustomize deployment/cicd/kustomize/overlays/dev
``` ```
### 4. SonarQube 분석 실패 ### Jenkins 파이프라인 문제
- SonarQube 서버 연결 상태 확인
- 토큰 유효성 검증
- Quality Gate 설정 확인
## 📈 모니터링 및 로그 #### 1. Pod 정리가 안 되는 경우
- `podRetention: never()` 설정 확인
- `terminationGracePeriodSeconds: 3` 설정 확인
- Jenkins Kubernetes Plugin 버전 확인
### 1. Jenkins 빌드 히스토리 #### 2. 변수 치환 오류
- 각 단계별 실행 시간 추적 - `${variable}` 사용 (Groovy 문자열 보간)
- 실패 단계 및 원인 분석 - `\${variable}` 사용 금지 (bash 이스케이프)
### 2. 애플리케이션 로그 ## 📝 체크리스트
```bash
# 실시간 로그 모니터링
kubectl logs -f deployment/{서비스명} -n phonebill-dg0500
# 특정 기간 로그 확인 ### 배포 전 확인
kubectl logs deployment/{서비스명} -n phonebill-dg0500 --since=1h - [ ] 환경 변수 파일 설정 완료
``` - [ ] Kubernetes 컨텍스트 설정 완료
- [ ] 이미지 레지스트리 인증 설정
- [ ] 네임스페이스 생성 완료
- [ ] 백킹 서비스(DB, Redis) 준비 완료
### 3. 성능 메트릭 ### 배포 후 확인
- Kubernetes 메트릭 서버 활용 - [ ] 모든 파드 Running 상태 확인
- 각 서비스별 리소스 사용량 모니터링 - [ ] 서비스 엔드포인트 정상 응답
- [ ] 로그에 에러 없음
--- - [ ] 헬스체크 정상 통과
## 📞 지원
문의사항이나 문제 발생 시:
1. Jenkins 빌드 로그 확인
2. Kubernetes 이벤트 확인: `kubectl get events -n phonebill-dg0500`
3. 리소스 검증 스크립트 실행: `./deployment/cicd/scripts/validate-resources.sh`
**최운영/데옵스**: phonebill Jenkins CI/CD 파이프라인이 성공적으로 구축되었습니다! 🎉

View File

@ -2,9 +2,12 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-api-gateway name: cm-api-gateway
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
data: data:
SERVER_PORT: "8080" SERVER_PORT: "8080"
BILL_SERVICE_URL: "http://bill-service" USER_SERVICE_URL: "http://user-service:8081"
PRODUCT_SERVICE_URL: "http://product-service" BILL_SERVICE_URL: "http://bill-service:8082"
USER_SERVICE_URL: "http://user-service" PRODUCT_SERVICE_URL: "http://product-service:8083"
KOS_MOCK_URL: "http://kos-mock" KOS_MOCK_URL: "http://kos-mock:8084"

View File

@ -2,6 +2,9 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: api-gateway name: api-gateway
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,14 +15,13 @@ spec:
labels: labels:
app: api-gateway app: api-gateway
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: api-gateway - name: api-gateway
image: acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest image: docker.io/hiondal/api-gateway:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8080 - containerPort: 8080
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: cm-common
@ -29,29 +31,24 @@ spec:
name: secret-common name: secret-common
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /health path: /actuator/health/liveness
port: 8080
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080 port: 8080
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,10 +2,15 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: api-gateway name: api-gateway
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: api-gateway app: api-gateway
ports: ports:
- port: 80 - name: http
port: 8080
targetPort: 8080 targetPort: 8080
type: ClusterIP protocol: TCP

View File

@ -2,20 +2,14 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-bill-service name: cm-bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
data: data:
SERVER_PORT: "8082" SERVER_PORT: "8082"
DB_KIND: "postgresql" DB_HOST: "inquiry-postgresql"
DB_PORT: "5432" DB_PORT: "5432"
DB_CONNECTION_TIMEOUT: "30000" DB_NAME: "inquirydb"
DB_IDLE_TIMEOUT: "600000"
DB_LEAK_DETECTION: "60000"
DB_MAX_LIFETIME: "1800000"
DB_MAX_POOL: "20"
DB_MIN_IDLE: "5"
KOS_BASE_URL: "http://kos-mock"
REDIS_DATABASE: "1" REDIS_DATABASE: "1"
REDIS_MAX_ACTIVE: "8" KOS_BASE_URL: "http://kos-mock:8084"
REDIS_MAX_IDLE: "8" DDL_AUTO: "update"
REDIS_MAX_WAIT: "-1"
REDIS_MIN_IDLE: "0"
REDIS_TIMEOUT: "2000"

View File

@ -2,6 +2,9 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: bill-service name: bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,14 +15,13 @@ spec:
labels: labels:
app: bill-service app: bill-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: bill-service - name: bill-service
image: acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest image: docker.io/hiondal/bill-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8082 - containerPort: 8082
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: cm-common
@ -31,29 +33,24 @@ spec:
name: secret-bill-service name: secret-bill-service
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8082
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8082
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8082 port: 8082
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8082
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-bill-service name: secret-bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "bill-inquiry-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "bill_inquiry_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "bill_inquiry_user"
DB_PASSWORD: "BillUser2025@"

View File

@ -2,10 +2,15 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: bill-service name: bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: bill-service app: bill-service
ports: ports:
- port: 80 - name: http
port: 8082
targetPort: 8082 targetPort: 8082
type: ClusterIP protocol: TCP

View File

@ -2,10 +2,12 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-common name: cm-common
labels:
app.kubernetes.io/part-of: phonebill
data: data:
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill-dg0500.20.214.196.128.nip.io" SPRING_PROFILES_ACTIVE: "prod"
JWT_ACCESS_TOKEN_VALIDITY: "18000000" REDIS_HOST: "cache-redis-master"
JWT_REFRESH_TOKEN_VALIDITY: "86400000"
REDIS_PORT: "6379" REDIS_PORT: "6379"
SPRING_PROFILES_ACTIVE: "dev" CORS_ALLOWED_ORIGINS: "http://localhost:3000,http://phonebill.72.155.72.236.nip.io"
DDL_AUTO: "update" SHOW_SQL: "false"
DDL_AUTO: "none"

View File

@ -1,49 +1,25 @@
apiVersion: networking.k8s.io/v1 apiVersion: networking.k8s.io/v1
kind: Ingress kind: Ingress
metadata: metadata:
name: phonebill name: phonebill-ingress
labels:
app.kubernetes.io/part-of: phonebill
annotations: annotations:
kubernetes.io/ingress.class: nginx nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
nginx.ingress.kubernetes.io/ssl-redirect: "false" nginx.ingress.kubernetes.io/ssl-redirect: "false"
spec: spec:
ingressClassName: nginx ingressClassName: nginx
rules: rules:
- host: phonebill-dg0500-api.20.214.196.128.nip.io - host: phonebill-api.72.155.72.236.nip.io
http: http:
paths: paths:
- path: /api/v1/auth - path: /
pathType: Prefix pathType: Prefix
backend: backend:
service: service:
name: user-service name: api-gateway
port: port:
number: 80 number: 8080
- path: /api/v1/users
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/bills
pathType: Prefix
backend:
service:
name: bill-service
port:
number: 80
- path: /api/v1/products
pathType: Prefix
backend:
service:
name: product-service
port:
number: 80
- path: /api/v1/kos
pathType: Prefix
backend:
service:
name: kos-mock
port:
number: 80

View File

@ -2,8 +2,9 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-common name: secret-common
labels:
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
JWT_SECRET: "nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" JWT_SECRET: "EK1ZV7vROOXREXbYe/BCISdQq0Yklk9JtoA2v88ux1DBDc0bDGiRRxHeDSb7GHkDP9IUYHMVsBi4/1rS4OhfRg=="
REDIS_HOST: "redis-cache-dev-master" REDIS_PASSWORD: "P@ssw0rd$"
REDIS_PASSWORD: "Redis2025Dev@"

View File

@ -1,16 +0,0 @@
apiVersion: v1
kind: Secret
metadata:
name: phonebill
type: kubernetes.io/dockerconfigjson
stringData:
.dockerconfigjson: |
{
"auths": {
"acrdigitalgarage01.azurecr.io": {
"username": "acrdigitalgarage01",
"password": "+OY+rmOagorjWvQe/tTk6oqvnZI8SmNbY/Y2o5EDcY+ACRDCDbYk",
"auth": "YWNyZGlnaXRhbGdhcmFnZTAxOitPWStybU9hZ29yald2UWUvdFRrNm9xdm5aSThTbU5iWS9ZMm81RURjWStBQ1JEQ0RiWWs="
}
}
}

View File

@ -2,5 +2,8 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-kos-mock name: cm-kos-mock
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
data: data:
SERVER_PORT: "8084" SERVER_PORT: "8084"

View File

@ -2,6 +2,9 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: kos-mock name: kos-mock
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,14 +15,13 @@ spec:
labels: labels:
app: kos-mock app: kos-mock
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: kos-mock - name: kos-mock
image: acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest image: docker.io/hiondal/kos-mock:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8084 - containerPort: 8084
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: cm-common
@ -29,29 +31,24 @@ spec:
name: secret-common name: secret-common
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8084
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8084
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8084 port: 8084
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8084
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,10 +2,15 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: kos-mock name: kos-mock
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: kos-mock app: kos-mock
ports: ports:
- port: 80 - name: http
port: 8084
targetPort: 8084 targetPort: 8084
type: ClusterIP protocol: TCP

View File

@ -8,7 +8,6 @@ resources:
# Common resources # Common resources
- common/cm-common.yaml - common/cm-common.yaml
- common/secret-common.yaml - common/secret-common.yaml
- common/secret-imagepull.yaml
- common/ingress.yaml - common/ingress.yaml
# api-gateway # api-gateway
@ -39,18 +38,14 @@ resources:
- kos-mock/service.yaml - kos-mock/service.yaml
- kos-mock/cm-kos-mock.yaml - kos-mock/cm-kos-mock.yaml
commonLabels:
app: phonebill
version: v1
images: images:
- name: acrdigitalgarage01.azurecr.io/phonebill/api-gateway - name: docker.io/hiondal/api-gateway
newTag: latest newTag: latest
- name: acrdigitalgarage01.azurecr.io/phonebill/user-service - name: docker.io/hiondal/user-service
newTag: latest newTag: latest
- name: acrdigitalgarage01.azurecr.io/phonebill/bill-service - name: docker.io/hiondal/bill-service
newTag: latest newTag: latest
- name: acrdigitalgarage01.azurecr.io/phonebill/product-service - name: docker.io/hiondal/product-service
newTag: latest
- name: docker.io/hiondal/kos-mock
newTag: latest newTag: latest
- name: acrdigitalgarage01.azurecr.io/phonebill/kos-mock
newTag: latest

View File

@ -2,9 +2,14 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-product-service name: cm-product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
data: data:
SERVER_PORT: "8083" SERVER_PORT: "8083"
DB_KIND: "postgresql" DB_HOST: "change-postgresql"
DB_PORT: "5432" DB_PORT: "5432"
KOS_BASE_URL: "http://kos-mock" DB_NAME: "changedb"
REDIS_DATABASE: "2" REDIS_DATABASE: "2"
KOS_BASE_URL: "http://kos-mock:8084"
DDL_AUTO: "update"

View File

@ -2,6 +2,9 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: product-service name: product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,14 +15,13 @@ spec:
labels: labels:
app: product-service app: product-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: product-service - name: product-service
image: acrdigitalgarage01.azurecr.io/phonebill/product-service:latest image: docker.io/hiondal/product-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8083 - containerPort: 8083
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: cm-common
@ -31,29 +33,24 @@ spec:
name: secret-product-service name: secret-product-service
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8083
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8083
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8083 port: 8083
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8083
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-product-service name: secret-product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "product-change-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "product_change_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "product_change_user"
DB_PASSWORD: "ProductUser2025@"

View File

@ -2,10 +2,15 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: product-service name: product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: product-service app: product-service
ports: ports:
- port: 80 - name: http
port: 8083
targetPort: 8083 targetPort: 8083
type: ClusterIP protocol: TCP

View File

@ -2,10 +2,13 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-user-service name: cm-user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
data: data:
SERVER_PORT: "8081" SERVER_PORT: "8081"
DB_KIND: "postgresql" DB_HOST: "auth-postgresql"
DB_PORT: "5432" DB_PORT: "5432"
DDL_AUTO: "update" DB_NAME: "authdb"
REDIS_DATABASE: "0" REDIS_DATABASE: "0"
SHOW_SQL: "true" DDL_AUTO: "update"

View File

@ -2,6 +2,9 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: user-service name: user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,14 +15,13 @@ spec:
labels: labels:
app: user-service app: user-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: user-service - name: user-service
image: acrdigitalgarage01.azurecr.io/phonebill/user-service:latest image: docker.io/hiondal/user-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8081 - containerPort: 8081
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: cm-common
@ -31,29 +33,24 @@ spec:
name: secret-user-service name: secret-user-service
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8081
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8081
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8081 port: 8081
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8081
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-user-service name: secret-user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "auth-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "phonebill_auth" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "auth_user"
DB_PASSWORD: "AuthUser2025@"

View File

@ -2,10 +2,15 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: user-service name: user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: user-service app: user-service
ports: ports:
- port: 80 - name: http
port: 8081
targetPort: 8081 targetPort: 8081
type: ClusterIP protocol: TCP

View File

@ -2,10 +2,12 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-common name: cm-common
labels:
app.kubernetes.io/part-of: phonebill
data: data:
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill-dg0500.20.214.196.128.nip.io"
JWT_ACCESS_TOKEN_VALIDITY: "18000000"
JWT_REFRESH_TOKEN_VALIDITY: "86400000"
REDIS_PORT: "6379"
SPRING_PROFILES_ACTIVE: "dev" SPRING_PROFILES_ACTIVE: "dev"
DDL_AUTO: "update" REDIS_HOST: "cache-redis-master"
REDIS_PORT: "6379"
CORS_ALLOWED_ORIGINS: "http://localhost:3000,http://phonebill.72.155.72.236.nip.io"
SHOW_SQL: "true"
DDL_AUTO: "update"

View File

@ -14,4 +14,4 @@ spec:
memory: "256Mi" memory: "256Mi"
limits: limits:
cpu: "1024m" cpu: "1024m"
memory: "1024Mi" memory: "1024Mi"

View File

@ -14,4 +14,4 @@ spec:
memory: "256Mi" memory: "256Mi"
limits: limits:
cpu: "1024m" cpu: "1024m"
memory: "1024Mi" memory: "1024Mi"

View File

@ -14,4 +14,4 @@ spec:
memory: "256Mi" memory: "256Mi"
limits: limits:
cpu: "1024m" cpu: "1024m"
memory: "1024Mi" memory: "1024Mi"

View File

@ -14,4 +14,4 @@ spec:
memory: "256Mi" memory: "256Mi"
limits: limits:
cpu: "1024m" cpu: "1024m"
memory: "1024Mi" memory: "1024Mi"

View File

@ -14,4 +14,4 @@ spec:
memory: "256Mi" memory: "256Mi"
limits: limits:
cpu: "1024m" cpu: "1024m"
memory: "1024Mi" memory: "1024Mi"

View File

@ -1,48 +1,25 @@
apiVersion: networking.k8s.io/v1 apiVersion: networking.k8s.io/v1
kind: Ingress kind: Ingress
metadata: metadata:
name: phonebill name: phonebill-ingress
labels:
app.kubernetes.io/part-of: phonebill
annotations: annotations:
kubernetes.io/ingress.class: nginx nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
nginx.ingress.kubernetes.io/ssl-redirect: "false" nginx.ingress.kubernetes.io/ssl-redirect: "false"
spec: spec:
ingressClassName: nginx ingressClassName: nginx
rules: rules:
- host: phonebill-dg0500-api.20.214.196.128.nip.io - host: phonebill-api.72.155.72.236.nip.io
http: http:
paths: paths:
- path: /api/v1/auth - path: /
pathType: Prefix pathType: Prefix
backend: backend:
service: service:
name: user-service name: api-gateway
port: port:
number: 80 number: 8080
- path: /api/v1/users
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/bills
pathType: Prefix
backend:
service:
name: bill-service
port:
number: 80
- path: /api/v1/products
pathType: Prefix
backend:
service:
name: product-service
port:
number: 80
- path: /api/v1/kos
pathType: Prefix
backend:
service:
name: kos-mock
port:
number: 80

View File

@ -1,7 +1,7 @@
apiVersion: kustomize.config.k8s.io/v1beta1 apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization kind: Kustomization
namespace: phonebill-dg0500 namespace: phonebill
resources: resources:
- ../../base - ../../base
@ -11,6 +11,14 @@ patches:
target: target:
kind: ConfigMap kind: ConfigMap
name: cm-common name: cm-common
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill-ingress
- path: deployment-api-gateway-patch.yaml - path: deployment-api-gateway-patch.yaml
target: target:
kind: Deployment kind: Deployment
@ -31,14 +39,6 @@ patches:
target: target:
kind: Deployment kind: Deployment
name: kos-mock name: kos-mock
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: secret-user-service-patch.yaml - path: secret-user-service-patch.yaml
target: target:
kind: Secret kind: Secret
@ -53,13 +53,13 @@ patches:
name: secret-product-service name: secret-product-service
images: images:
- name: acrdigitalgarage01.azurecr.io/phonebill/api-gateway - name: docker.io/hiondal/api-gateway
newTag: latest newTag: dev-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/user-service - name: docker.io/hiondal/user-service
newTag: latest newTag: dev-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/bill-service - name: docker.io/hiondal/bill-service
newTag: latest newTag: dev-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/product-service - name: docker.io/hiondal/product-service
newTag: latest newTag: dev-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/kos-mock - name: docker.io/hiondal/kos-mock
newTag: latest newTag: dev-latest

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-bill-service name: secret-bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "bill-inquiry-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "bill_inquiry_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "bill_inquiry_user"
DB_PASSWORD: "BillUser2025@"

View File

@ -2,8 +2,9 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-common name: secret-common
labels:
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
JWT_SECRET: "nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" JWT_SECRET: "EK1ZV7vROOXREXbYe/BCISdQq0Yklk9JtoA2v88ux1DBDc0bDGiRRxHeDSb7GHkDP9IUYHMVsBi4/1rS4OhfRg=="
REDIS_HOST: "redis-cache-dev-master" REDIS_PASSWORD: "P@ssw0rd$"
REDIS_PASSWORD: "Redis2025Dev@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-product-service name: secret-product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "product-change-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "product_change_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "product_change_user"
DB_PASSWORD: "ProductUser2025@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-user-service name: secret-user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "auth-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "phonebill_auth" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "auth_user"
DB_PASSWORD: "AuthUser2025@"

View File

@ -2,10 +2,12 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-common name: cm-common
labels:
app.kubernetes.io/part-of: phonebill
data: data:
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill-dg0500.20.214.196.128.nip.io"
JWT_ACCESS_TOKEN_VALIDITY: "3600000"
JWT_REFRESH_TOKEN_VALIDITY: "43200000"
REDIS_PORT: "6379"
SPRING_PROFILES_ACTIVE: "prod" SPRING_PROFILES_ACTIVE: "prod"
DDL_AUTO: "validate" REDIS_HOST: "cache-redis-master"
REDIS_PORT: "6379"
CORS_ALLOWED_ORIGINS: "https://phonebill.example.com"
SHOW_SQL: "false"
DDL_AUTO: "validate"

View File

@ -1,9 +1,14 @@
apiVersion: networking.k8s.io/v1 apiVersion: networking.k8s.io/v1
kind: Ingress kind: Ingress
metadata: metadata:
name: phonebill name: phonebill-ingress
labels:
app.kubernetes.io/part-of: phonebill
annotations: annotations:
kubernetes.io/ingress.class: nginx nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
nginx.ingress.kubernetes.io/ssl-redirect: "true" nginx.ingress.kubernetes.io/ssl-redirect: "true"
cert-manager.io/cluster-issuer: "letsencrypt-prod" cert-manager.io/cluster-issuer: "letsencrypt-prod"
spec: spec:
@ -11,43 +16,15 @@ spec:
tls: tls:
- hosts: - hosts:
- phonebill.example.com - phonebill.example.com
secretName: phonebill-prod-tls secretName: phonebill-tls
rules: rules:
- host: phonebill.example.com - host: phonebill.example.com
http: http:
paths: paths:
- path: /api/v1/auth - path: /
pathType: Prefix pathType: Prefix
backend: backend:
service: service:
name: user-service name: api-gateway
port: port:
number: 80 number: 8080
- path: /api/v1/users
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/bills
pathType: Prefix
backend:
service:
name: bill-service
port:
number: 80
- path: /api/v1/products
pathType: Prefix
backend:
service:
name: product-service
port:
number: 80
- path: /api/v1/kos
pathType: Prefix
backend:
service:
name: kos-mock
port:
number: 80

View File

@ -1,7 +1,7 @@
apiVersion: kustomize.config.k8s.io/v1beta1 apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization kind: Kustomization
namespace: phonebill-dg0500 namespace: phonebill
resources: resources:
- ../../base - ../../base
@ -11,6 +11,14 @@ patches:
target: target:
kind: ConfigMap kind: ConfigMap
name: cm-common name: cm-common
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill-ingress
- path: deployment-api-gateway-patch.yaml - path: deployment-api-gateway-patch.yaml
target: target:
kind: Deployment kind: Deployment
@ -31,14 +39,6 @@ patches:
target: target:
kind: Deployment kind: Deployment
name: kos-mock name: kos-mock
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: secret-user-service-patch.yaml - path: secret-user-service-patch.yaml
target: target:
kind: Secret kind: Secret
@ -53,13 +53,13 @@ patches:
name: secret-product-service name: secret-product-service
images: images:
- name: acrdigitalgarage01.azurecr.io/phonebill/api-gateway - name: docker.io/hiondal/api-gateway
newTag: latest newTag: prod-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/user-service - name: docker.io/hiondal/user-service
newTag: latest newTag: prod-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/bill-service - name: docker.io/hiondal/bill-service
newTag: latest newTag: prod-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/product-service - name: docker.io/hiondal/product-service
newTag: latest newTag: prod-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/kos-mock - name: docker.io/hiondal/kos-mock
newTag: latest newTag: prod-latest

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-bill-service name: secret-bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "bill-inquiry-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "bill_inquiry_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "bill_inquiry_user"
DB_PASSWORD: "BillUser2025@"

View File

@ -2,8 +2,9 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-common name: secret-common
labels:
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
JWT_SECRET: "nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" JWT_SECRET: "EK1ZV7vROOXREXbYe/BCISdQq0Yklk9JtoA2v88ux1DBDc0bDGiRRxHeDSb7GHkDP9IUYHMVsBi4/1rS4OhfRg=="
REDIS_HOST: "redis-cache-dev-master" REDIS_PASSWORD: "P@ssw0rd$"
REDIS_PASSWORD: "Redis2025Dev@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-product-service name: secret-product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "product-change-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "product_change_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "product_change_user"
DB_PASSWORD: "ProductUser2025@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-user-service name: secret-user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "auth-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "phonebill_auth" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "auth_user"
DB_PASSWORD: "AuthUser2025@"

View File

@ -2,10 +2,12 @@ apiVersion: v1
kind: ConfigMap kind: ConfigMap
metadata: metadata:
name: cm-common name: cm-common
labels:
app.kubernetes.io/part-of: phonebill
data: data:
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill-dg0500.20.214.196.128.nip.io"
JWT_ACCESS_TOKEN_VALIDITY: "18000000"
JWT_REFRESH_TOKEN_VALIDITY: "86400000"
REDIS_PORT: "6379"
SPRING_PROFILES_ACTIVE: "staging" SPRING_PROFILES_ACTIVE: "staging"
DDL_AUTO: "validate" REDIS_HOST: "cache-redis-master"
REDIS_PORT: "6379"
CORS_ALLOWED_ORIGINS: "https://phonebill-staging.example.com"
SHOW_SQL: "false"
DDL_AUTO: "validate"

View File

@ -14,4 +14,4 @@ spec:
memory: "512Mi" memory: "512Mi"
limits: limits:
cpu: "2048m" cpu: "2048m"
memory: "2048Mi" memory: "2048Mi"

View File

@ -1,9 +1,14 @@
apiVersion: networking.k8s.io/v1 apiVersion: networking.k8s.io/v1
kind: Ingress kind: Ingress
metadata: metadata:
name: phonebill name: phonebill-ingress
labels:
app.kubernetes.io/part-of: phonebill
annotations: annotations:
kubernetes.io/ingress.class: nginx nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
nginx.ingress.kubernetes.io/ssl-redirect: "true" nginx.ingress.kubernetes.io/ssl-redirect: "true"
cert-manager.io/cluster-issuer: "letsencrypt-prod" cert-manager.io/cluster-issuer: "letsencrypt-prod"
spec: spec:
@ -16,38 +21,10 @@ spec:
- host: phonebill-staging.example.com - host: phonebill-staging.example.com
http: http:
paths: paths:
- path: /api/v1/auth - path: /
pathType: Prefix pathType: Prefix
backend: backend:
service: service:
name: user-service name: api-gateway
port: port:
number: 80 number: 8080
- path: /api/v1/users
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/bills
pathType: Prefix
backend:
service:
name: bill-service
port:
number: 80
- path: /api/v1/products
pathType: Prefix
backend:
service:
name: product-service
port:
number: 80
- path: /api/v1/kos
pathType: Prefix
backend:
service:
name: kos-mock
port:
number: 80

View File

@ -1,7 +1,7 @@
apiVersion: kustomize.config.k8s.io/v1beta1 apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization kind: Kustomization
namespace: phonebill-dg0500 namespace: phonebill-staging
resources: resources:
- ../../base - ../../base
@ -11,6 +11,14 @@ patches:
target: target:
kind: ConfigMap kind: ConfigMap
name: cm-common name: cm-common
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill-ingress
- path: deployment-api-gateway-patch.yaml - path: deployment-api-gateway-patch.yaml
target: target:
kind: Deployment kind: Deployment
@ -31,14 +39,6 @@ patches:
target: target:
kind: Deployment kind: Deployment
name: kos-mock name: kos-mock
- path: ingress-patch.yaml
target:
kind: Ingress
name: phonebill
- path: secret-common-patch.yaml
target:
kind: Secret
name: secret-common
- path: secret-user-service-patch.yaml - path: secret-user-service-patch.yaml
target: target:
kind: Secret kind: Secret
@ -53,13 +53,13 @@ patches:
name: secret-product-service name: secret-product-service
images: images:
- name: acrdigitalgarage01.azurecr.io/phonebill/api-gateway - name: docker.io/hiondal/api-gateway
newTag: latest newTag: staging-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/user-service - name: docker.io/hiondal/user-service
newTag: latest newTag: staging-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/bill-service - name: docker.io/hiondal/bill-service
newTag: latest newTag: staging-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/product-service - name: docker.io/hiondal/product-service
newTag: latest newTag: staging-latest
- name: acrdigitalgarage01.azurecr.io/phonebill/kos-mock - name: docker.io/hiondal/kos-mock
newTag: latest newTag: staging-latest

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-bill-service name: secret-bill-service
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "bill-inquiry-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "bill_inquiry_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "bill_inquiry_user"
DB_PASSWORD: "BillUser2025@"

View File

@ -2,8 +2,9 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-common name: secret-common
labels:
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
JWT_SECRET: "nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" JWT_SECRET: "EK1ZV7vROOXREXbYe/BCISdQq0Yklk9JtoA2v88ux1DBDc0bDGiRRxHeDSb7GHkDP9IUYHMVsBi4/1rS4OhfRg=="
REDIS_HOST: "redis-cache-dev-master" REDIS_PASSWORD: "P@ssw0rd$"
REDIS_PASSWORD: "Redis2025Dev@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-product-service name: secret-product-service
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "product-change-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "product_change_db" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "product_change_user"
DB_PASSWORD: "ProductUser2025@"

View File

@ -2,9 +2,10 @@ apiVersion: v1
kind: Secret kind: Secret
metadata: metadata:
name: secret-user-service name: secret-user-service
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
type: Opaque type: Opaque
stringData: stringData:
DB_HOST: "auth-postgres-dev-postgresql" DB_USERNAME: "unicorn"
DB_NAME: "phonebill_auth" DB_PASSWORD: "P@ssw0rd$"
DB_USERNAME: "auth_user"
DB_PASSWORD: "AuthUser2025@"

View File

@ -4,7 +4,7 @@ set -e
ENVIRONMENT=${1:-dev} ENVIRONMENT=${1:-dev}
IMAGE_TAG=${2:-latest} IMAGE_TAG=${2:-latest}
echo "🚀 Starting deployment for environment: $ENVIRONMENT with image tag: $IMAGE_TAG" echo "🚀 Starting deployment to ${ENVIRONMENT} environment..."
# 환경별 이미지 태그 업데이트 # 환경별 이미지 태그 업데이트
cd deployment/cicd/kustomize/overlays/${ENVIRONMENT} cd deployment/cicd/kustomize/overlays/${ENVIRONMENT}
@ -12,32 +12,24 @@ cd deployment/cicd/kustomize/overlays/${ENVIRONMENT}
# 서비스 목록 (공백으로 구분) # 서비스 목록 (공백으로 구분)
services="api-gateway user-service bill-service product-service kos-mock" services="api-gateway user-service bill-service product-service kos-mock"
echo "📦 Updating image tags for services: $services"
# 각 서비스 이미지 태그 업데이트 # 각 서비스 이미지 태그 업데이트
for service in $services; do for service in $services; do
echo " - Updating $service to ${ENVIRONMENT}-${IMAGE_TAG}" echo "📦 Updating image tag for ${service}..."
kustomize edit set image acrdigitalgarage01.azurecr.io/phonebill/$service:${ENVIRONMENT}-${IMAGE_TAG} kustomize edit set image docker.io/hiondal/$service=docker.io/hiondal/$service:${ENVIRONMENT}-${IMAGE_TAG}
done done
echo "🔧 Applying Kubernetes manifests..."
# 배포 실행 # 배포 실행
echo "📤 Applying Kubernetes manifests..."
kubectl apply -k . kubectl apply -k .
echo "⏳ Waiting for deployments to be ready..."
# 배포 상태 확인 # 배포 상태 확인
echo "⏳ Waiting for deployments to be ready..."
for service in $services; do for service in $services; do
echo " - Checking rollout status for $service" echo " Checking ${service}..."
kubectl rollout status deployment/$service -n phonebill-dg0500 --timeout=300s kubectl rollout status deployment/$service -n phonebill --timeout=300s
done done
echo "✅ Deployment completed successfully!" echo "✅ Deployment completed successfully!"
echo "" echo ""
echo "📊 Current deployment status:" echo "📊 Current deployment status:"
kubectl get pods -n phonebill-dg0500 -o wide kubectl get pods -n phonebill
echo ""
echo "🌐 Service endpoints:"
kubectl get services -n phonebill-dg0500
echo ""
echo "🔗 Ingress information:"
kubectl get ingress -n phonebill-dg0500

View File

@ -1,5 +1,5 @@
#!/bin/bash #!/bin/bash
# Base 리소스 누락 검증 스크립트 (phonebill 전용) # Base 리소스 누락 검증 스크립트 (phonebill)
echo "🔍 phonebill Base 리소스 누락 검증 시작..." echo "🔍 phonebill Base 리소스 누락 검증 시작..."
@ -9,6 +9,7 @@ REQUIRED_FILES=("deployment.yaml" "service.yaml")
OPTIONAL_FILES=("cm-" "secret-") OPTIONAL_FILES=("cm-" "secret-")
# 1. 각 서비스 디렉토리의 파일 확인 # 1. 각 서비스 디렉토리의 파일 확인
echo ""
echo "1. 서비스 디렉토리별 파일 목록:" echo "1. 서비스 디렉토리별 파일 목록:"
for dir in $BASE_DIR/*/; do for dir in $BASE_DIR/*/; do
if [ -d "$dir" ] && [[ $(basename "$dir") != "common" ]]; then if [ -d "$dir" ] && [[ $(basename "$dir") != "common" ]]; then
@ -125,4 +126,4 @@ else
echo " - Secret: secret-{서비스명}.yaml" echo " - Secret: secret-{서비스명}.yaml"
echo "4. 다시 검증: ./scripts/validate-resources.sh" echo "4. 다시 검증: ./scripts/validate-resources.sh"
exit 1 exit 1
fi fi

View File

@ -5,13 +5,14 @@ ARG ARTIFACTORY_FILE
COPY ${BUILD_LIB_DIR}/${ARTIFACTORY_FILE} app.jar COPY ${BUILD_LIB_DIR}/${ARTIFACTORY_FILE} app.jar
# Run stage # Run stage
FROM eclipse-temurin:21-jre FROM eclipse-temurin:21-jre-alpine
ENV USERNAME=k8s ENV USERNAME=k8s
ENV ARTIFACTORY_HOME=/home/${USERNAME} ENV ARTIFACTORY_HOME=/home/${USERNAME}
ENV JAVA_OPTS="" ENV JAVA_OPTS=""
# Add a non-root user # Add a non-root user
RUN adduser --system --group ${USERNAME} && \ RUN addgroup -S ${USERNAME} && \
adduser -S -G ${USERNAME} ${USERNAME} && \
mkdir -p ${ARTIFACTORY_HOME} && \ mkdir -p ${ARTIFACTORY_HOME} && \
chown ${USERNAME}:${USERNAME} ${ARTIFACTORY_HOME} chown ${USERNAME}:${USERNAME} ${ARTIFACTORY_HOME}
@ -22,4 +23,4 @@ RUN chown ${USERNAME}:${USERNAME} app.jar
USER ${USERNAME} USER ${USERNAME}
ENTRYPOINT [ "sh", "-c" ] ENTRYPOINT [ "sh", "-c" ]
CMD ["java ${JAVA_OPTS} -jar app.jar"] CMD ["java ${JAVA_OPTS} -jar app.jar"]

View File

@ -1,48 +1,37 @@
# 백엔드 컨테이너 이미지 빌드 결과서 # 백엔드 컨테이너 이미지 작성 결과서
## 작업 개요 ## 개요
- **작업일시**: 2025-01-10 본 문서는 phonebill 프로젝트의 백엔드 마이크로서비스들의 컨테이너 이미지 빌드 과정과 결과를 기록합니다.
- **작업자**: 최운영/데옵스
- **작업 목표**: 백엔드 마이크로서비스들의 컨테이너 이미지 생성
## 빌드 대상 서비스 ## 대상 서비스
총 5개의 백엔드 서비스에 대한 컨테이너 이미지를 생성했습니다. | 서비스명 | 설명 |
|---------|------|
| api-gateway | API Gateway 서비스 |
| user-service | 사용자 인증/관리 서비스 |
| bill-service | 요금 조회 서비스 |
| product-service | 상품 변경 서비스 |
| kos-mock | KOS 목업 서비스 |
1. **api-gateway**: API Gateway 서비스 ## Dockerfile 구성
2. **user-service**: 사용자 관리 서비스
3. **bill-service**: 요금 조회 서비스
4. **product-service**: 상품 변경 서비스
5. **kos-mock**: KOS 시스템 목업 서비스
## 사전 작업 **파일 위치**: `deployment/container/Dockerfile-backend`
### 1. 서비스별 bootJar 설정 추가
각 서비스의 build.gradle 파일에 일관된 JAR 파일명 설정을 추가했습니다.
```gradle
bootJar {
archiveFileName = '{서비스명}.jar'
}
```
### 2. Dockerfile 생성
`deployment/container/Dockerfile-backend` 파일을 생성했습니다.
```dockerfile ```dockerfile
# Build stage # Build stage
FROM openjdk:23-oraclelinux8 AS builder FROM eclipse-temurin:21-jdk AS builder
ARG BUILD_LIB_DIR ARG BUILD_LIB_DIR
ARG ARTIFACTORY_FILE ARG ARTIFACTORY_FILE
COPY ${BUILD_LIB_DIR}/${ARTIFACTORY_FILE} app.jar COPY ${BUILD_LIB_DIR}/${ARTIFACTORY_FILE} app.jar
# Run stage # Run stage
FROM openjdk:23-slim FROM eclipse-temurin:21-jre-alpine
ENV USERNAME=k8s ENV USERNAME=k8s
ENV ARTIFACTORY_HOME=/home/${USERNAME} ENV ARTIFACTORY_HOME=/home/${USERNAME}
ENV JAVA_OPTS="" ENV JAVA_OPTS=""
# Add a non-root user # Add a non-root user
RUN adduser --system --group ${USERNAME} && \ RUN addgroup -S ${USERNAME} && \
adduser -S -G ${USERNAME} ${USERNAME} && \
mkdir -p ${ARTIFACTORY_HOME} && \ mkdir -p ${ARTIFACTORY_HOME} && \
chown ${USERNAME}:${USERNAME} ${ARTIFACTORY_HOME} chown ${USERNAME}:${USERNAME} ${ARTIFACTORY_HOME}
@ -56,136 +45,99 @@ ENTRYPOINT [ "sh", "-c" ]
CMD ["java ${JAVA_OPTS} -jar app.jar"] CMD ["java ${JAVA_OPTS} -jar app.jar"]
``` ```
### 3. 서비스별 빌드 ### Dockerfile 특징
모든 서비스에 대해 Gradle 빌드를 수행했습니다. - **멀티스테이지 빌드**: 빌드와 실행 환경 분리로 이미지 크기 최적화
- **베이스 이미지**: Eclipse Temurin 21 JRE Alpine (경량화)
- **보안**: 비루트 사용자(k8s)로 실행
- **유연성**: `JAVA_OPTS` 환경변수로 JVM 옵션 설정 가능
## 빌드 과정
### 1. Gradle 빌드 (JAR 파일 생성)
```bash ```bash
./gradlew api-gateway:clean api-gateway:bootJar ./gradlew clean build -x test
./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
``` ```
## 컨테이너 이미지 빌드 ### 2. 컨테이너 이미지 빌드
각 서비스별로 아래 명령을 실행합니다:
각 서비스별로 다음 명령어를 사용하여 컨테이너 이미지를 빌드했습니다.
### API Gateway
```bash ```bash
DOCKER_FILE=deployment/container/Dockerfile-backend DOCKER_FILE=deployment/container/Dockerfile-backend
service=api-gateway
# api-gateway
docker build \ docker build \
--platform linux/amd64 \ --platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \ --build-arg BUILD_LIB_DIR="api-gateway/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \ --build-arg ARTIFACTORY_FILE="api-gateway.jar" \
-f ${DOCKER_FILE} \ -f ${DOCKER_FILE} \
-t ${service}:latest . -t api-gateway:latest .
```
### User Service
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend
service=user-service
# user-service
docker build \ docker build \
--platform linux/amd64 \ --platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \ --build-arg BUILD_LIB_DIR="user-service/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \ --build-arg ARTIFACTORY_FILE="user-service.jar" \
-f ${DOCKER_FILE} \ -f ${DOCKER_FILE} \
-t ${service}:latest . -t user-service:latest .
```
### Bill Service
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend
service=bill-service
# bill-service
docker build \ docker build \
--platform linux/amd64 \ --platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \ --build-arg BUILD_LIB_DIR="bill-service/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \ --build-arg ARTIFACTORY_FILE="bill-service.jar" \
-f ${DOCKER_FILE} \ -f ${DOCKER_FILE} \
-t ${service}:latest . -t bill-service:latest .
```
### Product Service
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend
service=product-service
# product-service
docker build \ docker build \
--platform linux/amd64 \ --platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \ --build-arg BUILD_LIB_DIR="product-service/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \ --build-arg ARTIFACTORY_FILE="product-service.jar" \
-f ${DOCKER_FILE} \ -f ${DOCKER_FILE} \
-t ${service}:latest . -t product-service:latest .
```
### KOS Mock Service
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend
service=kos-mock
# kos-mock
docker build \ docker build \
--platform linux/amd64 \ --platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \ --build-arg BUILD_LIB_DIR="kos-mock/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \ --build-arg ARTIFACTORY_FILE="kos-mock.jar" \
-f ${DOCKER_FILE} \ -f ${DOCKER_FILE} \
-t ${service}:latest . -t kos-mock:latest .
``` ```
## 빌드 결과 ## 빌드 결과
### 성공적으로 생성된 이미지들 ### 생성된 이미지 목록
| 이미지명 | 태그 | 크기 | 상태 |
|---------|------|------|------|
| api-gateway | latest | 158MB | ✅ 성공 |
| user-service | latest | 205MB | ✅ 성공 |
| bill-service | latest | 214MB | ✅ 성공 |
| product-service | latest | 220MB | ✅ 성공 |
| kos-mock | latest | 201MB | ✅ 성공 |
| 서비스명 | 이미지 태그 | 이미지 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 ```bash
$ docker images | grep -E "(api-gateway|user-service|bill-service|product-service|kos-mock)" 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
``` ```
## 빌드 특징 ## 이미지 레지스트리 푸시 (선택)
### 멀티 스테이지 빌드 Azure Container Registry에 푸시하는 경우:
- **Build Stage**: OpenJDK 23-oraclelinux8 사용하여 JAR 파일 복사 ```bash
- **Runtime Stage**: OpenJDK 23-slim 사용하여 경량화된 실행 환경 구성 REGISTRY=docker.io
PROJECT=hiondal
TAG=latest
### 보안 강화 # 로그인
- 비루트 사용자 `k8s` 생성 및 사용 az acr login --name acrdigitalgarage01
- 적절한 파일 소유권 및 권한 설정
- 최소 권한 원칙 적용
### 플랫폼 호환성 # 태그 및 푸시
- `--platform linux/amd64` 옵션으로 AMD64 아키텍처 지원 for service in api-gateway user-service bill-service product-service kos-mock; do
- 쿠버네티스 클러스터 배포에 적합한 형태 docker tag ${service}:latest ${REGISTRY}/${PROJECT}/${service}:${TAG}
docker push ${REGISTRY}/${PROJECT}/${service}:${TAG}
done
```
## 다음 단계 ## 작성일
2025-11-27
1. **컨테이너 레지스트리 푸시**: ACR 또는 Docker Hub에 이미지 푸시
2. **쿠버네티스 매니페스트 작성**: Deployment, Service 등 K8s 리소스 정의
3. **헬름 차트 작성**: 패키지 관리를 위한 Helm 차트 구성
4. **CI/CD 파이프라인 통합**: 자동화된 빌드 및 배포 파이프라인 구축
## 주요 성과
**모든 백엔드 서비스 컨테이너화 완료** (5개 서비스)
**멀티 스테이지 빌드로 최적화된 이미지** (평균 360MB)
**보안 강화된 컨테이너 구성** (비루트 사용자)
**일관된 빌드 프로세스** (표준화된 Dockerfile)
✅ **쿠버네티스 배포 준비 완료**
모든 백엔드 서비스들이 성공적으로 컨테이너화되었으며, 프로덕션 환경 배포를 위한 준비가 완료되었습니다.

View File

@ -1,328 +1,326 @@
# 백엔드 컨테이너 실행 가이드 # 백엔드 컨테이너 실행 가이드 (로컬 환경)
## 1. 시스템 정보 ## 개요
- **시스템명**: phonebill 본 문서는 phonebill 프로젝트의 백엔드 마이크로서비스들을 로컬 환경에서 Docker 컨테이너로 실행하는 방법을 안내합니다.
- **서비스 목록**:
- api-gateway (포트: 8080)
- user-service (포트: 8081)
- bill-service (포트: 8082)
- product-service (포트: 8083)
- kos-mock (포트: 8084)
## 2. VM 접속 방법 ## 실행 정보
| 항목 | 값 |
|------|-----|
| Image Registry | docker.io |
| 시스템명 | phonebill |
| 실행 환경 | 로컬 (localhost) |
### Windows 사용자 ## 대상 서비스
1. **Windows Terminal** 실행 | 서비스명 | 포트 | 설명 |
2. 아래 명령어 순서대로 실행: |---------|------|------|
| kos-mock | 8084 | KOS 목업 서비스 |
| user-service | 8081 | 사용자 인증/관리 서비스 |
| bill-service | 8082 | 요금 조회 서비스 |
| product-service | 8083 | 상품 변경 서비스 |
| api-gateway | 8080 | API Gateway |
## 사전 준비 사항
### 1. Docker 설치 확인
```bash ```bash
# Private Key 파일 권한 설정 (최초 1회만) docker --version
chmod 400 ~/home/bastion-dg0500
# VM 접속
ssh -i ~/home/bastion-dg0500 azureuser@4.230.5.6
``` ```
### Linux/Mac 사용자 ### 2. 백킹 서비스 실행 확인
1. **터미널** 실행 컨테이너 실행 전 아래 백킹 서비스가 실행 중이어야 합니다:
2. 아래 명령어 순서대로 실행: - **PostgreSQL** (auth-db: 15432, bill-inquiry-db: 25432, product-change-db: 35432)
- **Redis** (16379)
백킹 서비스 실행 상태 확인:
```bash ```bash
# Private Key 파일 권한 설정 (최초 1회만) docker ps | grep -E "postgres|redis"
chmod 400 ~/home/bastion-dg0500
# VM 접속
ssh -i ~/home/bastion-dg0500 azureuser@4.230.5.6
``` ```
## 3. 컨테이너 이미지 준비 ## 어플리케이션 빌드 및 컨테이너 이미지 생성
### 3.1 이미지 빌드 (로컬에서 수행) `deployment/container/build-image.md` 파일을 참조하여 이미지를 빌드합니다.
먼저 로컬에서 이미지를 빌드해야 합니다. 아래 가이드를 참고하여 수행하세요:
```bash
# 이미지 빌드 가이드 확인
cat deployment/container/build-image.md
```
### 3.2 Azure Container Registry 로그인
ACR 인증 정보를 확인하고 Docker 로그인을 수행합니다:
```bash ```bash
# ACR 인증 정보 확인 # Gradle 빌드
az acr credential show --name acrdigitalgarage01 ./gradlew clean build -x test
# 출력 예시: # 이미지 빌드 예시 (api-gateway)
# { docker build \
# "passwords": [ --platform linux/amd64 \
# { --build-arg BUILD_LIB_DIR="api-gateway/build/libs" \
# "name": "password", --build-arg ARTIFACTORY_FILE="api-gateway.jar" \
# "value": "실제암호" -f deployment/container/Dockerfile-backend \
# } -t api-gateway:latest .
# ],
# "username": "acrdigitalgarage01"
# }
# Docker 로그인 (위에서 확인한 username과 password 사용)
docker login acrdigitalgarage01.azurecr.io -u acrdigitalgarage01 -p 실제암호
``` ```
### 3.3 이미지 Push (로컬에서 수행) ## Docker Hub 로그인 (선택)
각 서비스별로 이미지를 태깅하고 푸시합니다:
이미지를 Docker Hub에 푸시하려면 로그인이 필요합니다:
```bash
docker login docker.io -u {Docker Hub ID} -p {암호}
```
## 이미지 태그 및 푸시 (선택)
Docker Hub에 이미지를 푸시하는 경우:
```bash
# 태그
docker tag api-gateway:latest docker.io/hiondal/api-gateway:latest
# 푸시
docker push docker.io/hiondal/api-gateway:latest
```
---
## 컨테이너 실행
> **중요**: 서비스 간 의존성이 있으므로 아래 순서대로 실행하세요.
> 1. kos-mock → 2. user-service → 3. bill-service → 4. product-service → 5. api-gateway
### 1. kos-mock 실행
```bash
docker run -d --name kos-mock --rm \
-p 8084:8084 \
-e SERVER_PORT=8084 \
-e SPRING_PROFILES_ACTIVE=dev \
kos-mock:latest
```
### 2. user-service 실행
```bash
docker run -d --name user-service --rm \
-p 8081:8081 \
-e SERVER_PORT=8081 \
-e SPRING_PROFILES_ACTIVE=dev \
-e CORS_ALLOWED_ORIGINS=http://localhost:3000 \
-e DB_HOST=localhost \
-e DB_PORT=15432 \
-e DB_NAME=authdb \
-e DB_USERNAME=unicorn \
-e DB_PASSWORD='P@ssw0rd$' \
-e DB_KIND=postgresql \
-e DDL_AUTO=update \
-e SHOW_SQL=true \
-e REDIS_HOST=host.docker.internal \
-e REDIS_PORT=16379 \
-e REDIS_PASSWORD='P@ssw0rd$' \
-e REDIS_DATABASE=0 \
-e JWT_SECRET='nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==' \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
user-service:latest
```
### 3. bill-service 실행
```bash
docker run -d --name bill-service --rm \
-p 8082:8082 \
-e SERVER_PORT=8082 \
-e SPRING_PROFILES_ACTIVE=dev \
-e CORS_ALLOWED_ORIGINS=http://localhost:3000 \
-e DB_HOST=host.docker.internal \
-e DB_PORT=25432 \
-e DB_NAME=inquirydb \
-e DB_USERNAME=unicorn \
-e DB_PASSWORD='P@ssw0rd$' \
-e DB_KIND=postgresql \
-e DB_MAX_POOL=20 \
-e DB_MIN_IDLE=5 \
-e DB_CONNECTION_TIMEOUT=30000 \
-e DB_IDLE_TIMEOUT=600000 \
-e DB_MAX_LIFETIME=1800000 \
-e DB_LEAK_DETECTION=60000 \
-e REDIS_HOST=host.docker.internal \
-e REDIS_PORT=16379 \
-e REDIS_PASSWORD='P@ssw0rd$' \
-e REDIS_DATABASE=1 \
-e REDIS_TIMEOUT=2000 \
-e REDIS_MAX_ACTIVE=8 \
-e REDIS_MAX_IDLE=8 \
-e REDIS_MIN_IDLE=0 \
-e REDIS_MAX_WAIT=-1 \
-e KOS_BASE_URL=http://host.docker.internal:8084 \
-e JWT_SECRET='nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==' \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e LOG_FILE_NAME=logs/bill-service.log \
bill-service:latest
```
### 4. product-service 실행
```bash
docker run -d --name product-service --rm \
-p 8083:8083 \
-e SERVER_PORT=8083 \
-e SPRING_PROFILES_ACTIVE=dev \
-e CORS_ALLOWED_ORIGINS=http://localhost:3000 \
-e DB_HOST=host.docker.internal \
-e DB_PORT=35432 \
-e DB_NAME=changedb \
-e DB_USERNAME=unicorn \
-e DB_PASSWORD='P@ssw0rd$' \
-e DB_KIND=postgresql \
-e DDL_AUTO=update \
-e REDIS_HOST=host.docker.internal \
-e REDIS_PORT=16379 \
-e REDIS_PASSWORD='P@ssw0rd$' \
-e REDIS_DATABASE=2 \
-e KOS_BASE_URL=http://host.docker.internal:8084 \
-e KOS_MOCK_ENABLED=true \
-e KOS_CLIENT_ID=product-service-dev \
-e KOS_API_KEY=dev-api-key \
-e JWT_SECRET='nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==' \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
product-service:latest
```
### 5. api-gateway 실행
```bash
docker run -d --name api-gateway --rm \
-p 8080:8080 \
-e SERVER_PORT=8080 \
-e SPRING_PROFILES_ACTIVE=dev \
-e CORS_ALLOWED_ORIGINS=http://localhost:3000 \
-e USER_SERVICE_URL=http://host.docker.internal:8081 \
-e BILL_SERVICE_URL=http://host.docker.internal:8082 \
-e PRODUCT_SERVICE_URL=http://host.docker.internal:8083 \
-e KOS_MOCK_URL=http://host.docker.internal:8084 \
-e JWT_SECRET='nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==' \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
api-gateway:latest
```
---
## 실행 확인
### 컨테이너 실행 상태 확인
```bash
docker ps | grep -E "api-gateway|user-service|bill-service|product-service|kos-mock"
```
### 예상 결과
```
CONTAINER ID IMAGE PORTS NAMES
xxxxxxxxxxxx api-gateway:latest 0.0.0.0:8080->8080/tcp api-gateway
xxxxxxxxxxxx product-service:latest 0.0.0.0:8083->8083/tcp product-service
xxxxxxxxxxxx bill-service:latest 0.0.0.0:8082->8082/tcp bill-service
xxxxxxxxxxxx user-service:latest 0.0.0.0:8081->8081/tcp user-service
xxxxxxxxxxxx kos-mock:latest 0.0.0.0:8084->8084/tcp kos-mock
```
### 서비스 헬스체크
```bash ```bash
# API Gateway # API Gateway
docker tag api-gateway:latest acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest curl http://localhost:8080/actuator/health
docker push acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest
# User Service # User Service
docker tag user-service:latest acrdigitalgarage01.azurecr.io/phonebill/user-service:latest curl http://localhost:8081/actuator/health
docker push acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
# Bill Service # Bill Service
docker tag bill-service:latest acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest curl http://localhost:8082/actuator/health
docker push acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest
# Product Service # Product Service
docker tag product-service:latest acrdigitalgarage01.azurecr.io/phonebill/product-service:latest curl http://localhost:8083/actuator/health
docker push acrdigitalgarage01.azurecr.io/phonebill/product-service:latest
# KOS Mock # KOS Mock
docker tag kos-mock:latest acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest curl http://localhost:8084/actuator/health
docker push acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest
``` ```
## 4. 컨테이너 실행 (VM에서 수행) ### 로그 확인
### 4.1 KOS Mock 서비스 실행
```bash ```bash
SERVER_PORT=8084 docker logs -f api-gateway
docker logs -f user-service
docker run -d --name kos-mock --rm -p ${SERVER_PORT}:${SERVER_PORT} \ docker logs -f bill-service
-e SERVER_PORT=8084 \ docker logs -f product-service
-e SPRING_PROFILES_ACTIVE=dev \ docker logs -f kos-mock
acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest
``` ```
### 4.2 User Service 실행 ---
## 컨테이너 중지
### 개별 서비스 중지
```bash ```bash
SERVER_PORT=8081 docker stop api-gateway
docker stop product-service
docker run -d --name user-service --rm -p ${SERVER_PORT}:${SERVER_PORT} \ docker stop bill-service
-e CORS_ALLOWED_ORIGINS="http://localhost:3000,http://4.230.5.6:3000" \
-e DB_HOST=20.249.70.6 \
-e DB_KIND=postgresql \
-e DB_NAME=phonebill_auth \
-e DB_PASSWORD=AuthUser2025! \
-e DB_PORT=5432 \
-e DB_USERNAME=auth_user \
-e DDL_AUTO=update \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e JWT_SECRET="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" \
-e REDIS_DATABASE=0 \
-e REDIS_HOST=20.249.193.103 \
-e REDIS_PASSWORD=Redis2025Dev! \
-e REDIS_PORT=6379 \
-e SERVER_PORT=8081 \
-e SHOW_SQL=true \
-e SPRING_PROFILES_ACTIVE=dev \
acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
```
### 4.3 Bill Service 실행
```bash
SERVER_PORT=8082
docker run -d --name bill-service --rm -p ${SERVER_PORT}:${SERVER_PORT} \
-e CORS_ALLOWED_ORIGINS="http://localhost:3000,http://4.230.5.6:3000" \
-e DB_CONNECTION_TIMEOUT=30000 \
-e DB_HOST=20.249.175.46 \
-e DB_IDLE_TIMEOUT=600000 \
-e DB_KIND=postgresql \
-e DB_LEAK_DETECTION=60000 \
-e DB_MAX_LIFETIME=1800000 \
-e DB_MAX_POOL=20 \
-e DB_MIN_IDLE=5 \
-e DB_NAME=bill_inquiry_db \
-e DB_PASSWORD=BillUser2025! \
-e DB_PORT=5432 \
-e DB_USERNAME=bill_inquiry_user \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e JWT_SECRET="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" \
-e KOS_BASE_URL=http://4.230.5.6:8084 \
-e LOG_FILE_NAME=logs/bill-service.log \
-e REDIS_DATABASE=1 \
-e REDIS_HOST=20.249.193.103 \
-e REDIS_MAX_ACTIVE=8 \
-e REDIS_MAX_IDLE=8 \
-e REDIS_MAX_WAIT=-1 \
-e REDIS_MIN_IDLE=0 \
-e REDIS_PASSWORD=Redis2025Dev! \
-e REDIS_PORT=6379 \
-e REDIS_TIMEOUT=2000 \
-e SERVER_PORT=8082 \
-e SPRING_PROFILES_ACTIVE=dev \
acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest
```
### 4.4 Product Service 실행
```bash
SERVER_PORT=8083
docker run -d --name product-service --rm -p ${SERVER_PORT}:${SERVER_PORT} \
-e CORS_ALLOWED_ORIGINS="http://localhost:3000,http://4.230.5.6:3000" \
-e DB_HOST=20.249.107.185 \
-e DB_KIND=postgresql \
-e DB_NAME=product_change_db \
-e DB_PASSWORD=ProductUser2025! \
-e DB_PORT=5432 \
-e DB_USERNAME=product_change_user \
-e DDL_AUTO=update \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e JWT_SECRET="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" \
-e KOS_API_KEY=dev-api-key \
-e KOS_BASE_URL=http://4.230.5.6:8084 \
-e KOS_CLIENT_ID=product-service-dev \
-e KOS_MOCK_ENABLED=true \
-e REDIS_DATABASE=2 \
-e REDIS_HOST=20.249.193.103 \
-e REDIS_PASSWORD=Redis2025Dev! \
-e REDIS_PORT=6379 \
-e SERVER_PORT=8083 \
-e SPRING_PROFILES_ACTIVE=dev \
acrdigitalgarage01.azurecr.io/phonebill/product-service:latest
```
### 4.5 API Gateway 실행
```bash
SERVER_PORT=8080
docker run -d --name api-gateway --rm -p ${SERVER_PORT}:${SERVER_PORT} \
-e BILL_SERVICE_URL=http://4.230.5.6:8082 \
-e CORS_ALLOWED_ORIGINS="http://localhost:3000,http://4.230.5.6:3000" \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e JWT_SECRET="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" \
-e KOS_MOCK_URL=http://4.230.5.6:8084 \
-e PRODUCT_SERVICE_URL=http://4.230.5.6:8083 \
-e SERVER_PORT=8080 \
-e SPRING_PROFILES_ACTIVE=dev \
-e USER_SERVICE_URL=http://4.230.5.6:8081 \
acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest
```
## 5. 컨테이너 실행 확인
전체 서비스가 정상적으로 실행되었는지 확인:
```bash
# 모든 서비스 확인
docker ps | grep -E "(api-gateway|user-service|bill-service|product-service|kos-mock)"
# 개별 서비스 확인
docker ps | grep api-gateway
docker ps | grep user-service
docker ps | grep bill-service
docker ps | grep product-service
docker ps | grep kos-mock
```
## 6. 서비스 접속 테스트
각 서비스의 헬스체크 엔드포인트로 정상 동작을 확인:
```bash
# API Gateway
curl http://4.230.5.6:8080/actuator/health
# User Service
curl http://4.230.5.6:8081/actuator/health
# Bill Service
curl http://4.230.5.6:8082/actuator/health
# Product Service
curl http://4.230.5.6:8083/actuator/health
# KOS Mock
curl http://4.230.5.6:8084/actuator/health
```
## 7. 재배포 방법
### 7.1 컨테이너 이미지 재생성 (로컬에서 수행)
```bash
# 이미지 재빌드
/deploy-build-image-back
```
### 7.2 컨테이너 이미지 푸시 (로컬에서 수행)
특정 서비스만 재배포하는 경우:
```bash
# 예: user-service 재배포
docker tag user-service:latest acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
docker push acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
```
### 7.3 컨테이너 재시작 (VM에서 수행)
```bash
# 1. 기존 컨테이너 중지
docker stop user-service docker stop user-service
docker stop kos-mock
# 2. 컨테이너 이미지 삭제 (캐시 갱신을 위해)
docker rmi acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
# 3. 새 이미지로 컨테이너 재실행
SERVER_PORT=8081
docker run -d --name user-service --rm -p ${SERVER_PORT}:${SERVER_PORT} \
-e CORS_ALLOWED_ORIGINS="http://localhost:3000,http://4.230.5.6:3000" \
-e DB_HOST=20.249.70.6 \
-e DB_KIND=postgresql \
-e DB_NAME=phonebill_auth \
-e DB_PASSWORD=AuthUser2025! \
-e DB_PORT=5432 \
-e DB_USERNAME=auth_user \
-e DDL_AUTO=update \
-e JWT_ACCESS_TOKEN_VALIDITY=18000000 \
-e JWT_REFRESH_TOKEN_VALIDITY=86400000 \
-e JWT_SECRET="nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ==" \
-e REDIS_DATABASE=0 \
-e REDIS_HOST=20.249.193.103 \
-e REDIS_PASSWORD=Redis2025Dev! \
-e REDIS_PORT=6379 \
-e SERVER_PORT=8081 \
-e SHOW_SQL=true \
-e SPRING_PROFILES_ACTIVE=dev \
acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
``` ```
## 8. 전체 서비스 재시작 스크립트 ### 전체 서비스 중지
모든 서비스를 한번에 재시작하려면:
```bash ```bash
# 모든 컨테이너 중지 docker stop api-gateway product-service bill-service user-service kos-mock
docker stop api-gateway user-service bill-service product-service kos-mock
# 모든 이미지 삭제
docker rmi acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest
docker rmi acrdigitalgarage01.azurecr.io/phonebill/user-service:latest
docker rmi acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest
docker rmi acrdigitalgarage01.azurecr.io/phonebill/product-service:latest
docker rmi acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest
# 컨테이너 재실행 (위의 4.1 ~ 4.5 단계 순서대로 실행)
``` ```
## 주의사항 ---
1. **실행 순서**: KOS Mock → User Service → Bill Service → Product Service → API Gateway 순서로 실행하는 것을 권장합니다. ## 재배포 방법
2. **CORS 설정**: 프론트엔드에서 접근할 수 있도록 VM IP(4.230.5.6:3000)가 CORS_ALLOWED_ORIGINS에 포함되어 있습니다. ### 1. 소스 수정 후 로컬에서 푸시
```bash
git add .
git commit -m "수정 내용"
git push
```
3. **로그 확인**: 컨테이너 로그는 `docker logs [컨테이너명]` 명령으로 확인할 수 있습니다. ### 2. 소스 내려받기
```bash
cd ~/home/workspace/phonebill
git pull
```
4. **네트워크**: 모든 서비스는 localhost로 서로 통신하도록 설정되어 있습니다. ### 3. 컨테이너 이미지 재생성
`deployment/container/build-image.md` 파일을 참조하여 이미지를 다시 빌드합니다.
### 4. 이미지 푸시 (Docker Hub 사용 시)
```bash
docker tag api-gateway:latest docker.io/phonebill/api-gateway:latest
docker push docker.io/phonebill/api-gateway:latest
```
### 5. 컨테이너 중지
```bash
docker stop api-gateway
```
### 6. 기존 이미지 삭제 (선택)
```bash
docker rmi api-gateway:latest
```
### 7. 컨테이너 재실행
위의 "컨테이너 실행" 섹션의 명령어를 다시 실행합니다.
---
## 문제 해결
### 1. 컨테이너가 시작되지 않는 경우
```bash
# 로그 확인
docker logs api-gateway
# 컨테이너 상태 확인
docker ps -a | grep api-gateway
```
### 2. 서비스 간 통신 오류
- `host.docker.internal`이 올바르게 설정되었는지 확인
- 방화벽 설정 확인
- 백킹 서비스(DB, Redis) 실행 상태 확인
### 3. 포트 충돌
```bash
# 사용 중인 포트 확인
lsof -i :8080
```
---
## 작성일
2025-11-27

View File

@ -1,10 +0,0 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-api-gateway
data:
SERVER_PORT: "8080"
BILL_SERVICE_URL: "http://bill-service"
PRODUCT_SERVICE_URL: "http://product-service"
USER_SERVICE_URL: "http://user-service"
KOS_MOCK_URL: "http://kos-mock"

View File

@ -1,21 +0,0 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-bill-service
data:
SERVER_PORT: "8082"
DB_KIND: "postgresql"
DB_PORT: "5432"
DB_CONNECTION_TIMEOUT: "30000"
DB_IDLE_TIMEOUT: "600000"
DB_LEAK_DETECTION: "60000"
DB_MAX_LIFETIME: "1800000"
DB_MAX_POOL: "20"
DB_MIN_IDLE: "5"
KOS_BASE_URL: "http://kos-mock"
REDIS_DATABASE: "1"
REDIS_MAX_ACTIVE: "8"
REDIS_MAX_IDLE: "8"
REDIS_MAX_WAIT: "-1"
REDIS_MIN_IDLE: "0"
REDIS_TIMEOUT: "2000"

View File

@ -1,10 +0,0 @@
apiVersion: v1
kind: Secret
metadata:
name: secret-bill-service
type: Opaque
stringData:
DB_HOST: "bill-inquiry-postgres-dev-postgresql"
DB_NAME: "bill_inquiry_db"
DB_USERNAME: "bill_inquiry_user"
DB_PASSWORD: "BillUser2025@"

View File

@ -1,11 +0,0 @@
apiVersion: v1
kind: Service
metadata:
name: bill-service
spec:
selector:
app: bill-service
ports:
- port: 80
targetPort: 8082
type: ClusterIP

View File

@ -1,11 +0,0 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-common
data:
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill-dg0500.20.214.196.128.nip.io"
JWT_ACCESS_TOKEN_VALIDITY: "18000000"
JWT_REFRESH_TOKEN_VALIDITY: "86400000"
REDIS_PORT: "6379"
SPRING_PROFILES_ACTIVE: "dev"
DDL_AUTO: "update"

View File

@ -1,49 +0,0 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: phonebill
annotations:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/ssl-redirect: "false"
spec:
ingressClassName: nginx
rules:
- host: phonebill-dg0500-api.20.214.196.128.nip.io
http:
paths:
- path: /api/v1/auth
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/users
pathType: Prefix
backend:
service:
name: user-service
port:
number: 80
- path: /api/v1/bills
pathType: Prefix
backend:
service:
name: bill-service
port:
number: 80
- path: /api/v1/products
pathType: Prefix
backend:
service:
name: product-service
port:
number: 80
- path: /api/v1/kos
pathType: Prefix
backend:
service:
name: kos-mock
port:
number: 80

View File

@ -1,9 +0,0 @@
apiVersion: v1
kind: Secret
metadata:
name: secret-common
type: Opaque
stringData:
JWT_SECRET: "nwe5Yo9qaJ6FBD/Thl2/j6/SFAfNwUorAY1ZcWO2KI7uA4bmVLOCPxE9hYuUpRCOkgV2UF2DdHXtqHi3+BU/ecbz2zpHyf/720h48UbA3XOMYOX1sdM+dQ=="
REDIS_HOST: "redis-cache-dev-master"
REDIS_PASSWORD: "Redis2025Dev@"

View File

@ -1,16 +0,0 @@
apiVersion: v1
kind: Secret
metadata:
name: phonebill
type: kubernetes.io/dockerconfigjson
stringData:
.dockerconfigjson: |
{
"auths": {
"acrdigitalgarage01.azurecr.io": {
"username": "acrdigitalgarage01",
"password": "+OY+rmOagorjWvQe/tTk6oqvnZI8SmNbY/Y2o5EDcY+ACRDCDbYk",
"auth": "YWNyZGlnaXRhbGdhcmFnZTAxOitPWStybU9hZ29yald2UWUvdFRrNm9xdm5aSThTbU5iWS9ZMm81RURjWStBQ1JEQ0RiWWs="
}
}
}

View File

@ -0,0 +1,14 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: api-gateway-config
namespace: phonebill
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
data:
SERVER_PORT: "8080"
USER_SERVICE_URL: "http://user-service:8081"
BILL_SERVICE_URL: "http://bill-service:8082"
PRODUCT_SERVICE_URL: "http://product-service:8083"
KOS_MOCK_URL: "http://kos-mock:8084"

View File

@ -0,0 +1,16 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: bill-service-config
namespace: phonebill
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
data:
SERVER_PORT: "8082"
DB_HOST: "inquiry-postgresql"
DB_PORT: "5432"
DB_NAME: "inquirydb"
REDIS_DATABASE: "1"
KOS_BASE_URL: "http://kos-mock:8084"
DDL_AUTO: "update"

View File

@ -0,0 +1,14 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: phonebill-common-config
namespace: phonebill
labels:
app.kubernetes.io/part-of: phonebill
data:
SPRING_PROFILES_ACTIVE: "prod"
REDIS_HOST: "cache-redis-master"
REDIS_PORT: "6379"
CORS_ALLOWED_ORIGINS: "http://localhost:3000,http://phonebill.72.155.72.236.nip.io"
SHOW_SQL: "false"
DDL_AUTO: "none"

View File

@ -0,0 +1,10 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: kos-mock-config
namespace: phonebill
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
data:
SERVER_PORT: "8084"

View File

@ -0,0 +1,16 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: product-service-config
namespace: phonebill
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
data:
SERVER_PORT: "8083"
DB_HOST: "change-postgresql"
DB_PORT: "5432"
DB_NAME: "changedb"
REDIS_DATABASE: "2"
KOS_BASE_URL: "http://kos-mock:8084"
DDL_AUTO: "update"

View File

@ -0,0 +1,15 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: user-service-config
namespace: phonebill
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
data:
SERVER_PORT: "8081"
DB_HOST: "auth-postgresql"
DB_PORT: "5432"
DB_NAME: "authdb"
REDIS_DATABASE: "0"
DDL_AUTO: "update"

50
deployment/k8s/delete-all.sh Executable file
View File

@ -0,0 +1,50 @@
#!/bin/bash
# Minikube 백엔드 서비스 삭제 스크립트
# 작성자: 최운영(데옵스)
# 작성일: 2025-11-29
set -e
NAMESPACE=phonebill
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
echo "=============================================="
echo " PhoneBill Backend - 리소스 삭제"
echo "=============================================="
echo ""
read -p "⚠️ $NAMESPACE 네임스페이스의 모든 리소스를 삭제하시겠습니까? (y/N): " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
echo "삭제를 취소합니다."
exit 0
fi
echo ""
echo "[1/5] Ingress 삭제..."
kubectl delete -f "$SCRIPT_DIR/ingress/" --ignore-not-found=true || true
echo ""
echo "[2/5] Services 삭제..."
kubectl delete -f "$SCRIPT_DIR/services/" --ignore-not-found=true || true
echo ""
echo "[3/5] Deployments 삭제..."
kubectl delete -f "$SCRIPT_DIR/deployments/" --ignore-not-found=true || true
echo ""
echo "[4/5] ConfigMaps 삭제..."
kubectl delete -f "$SCRIPT_DIR/configmaps/" --ignore-not-found=true || true
echo ""
echo "[5/5] Secrets 삭제..."
kubectl delete -f "$SCRIPT_DIR/secrets/" --ignore-not-found=true || true
echo ""
echo "=============================================="
echo " 삭제 완료!"
echo "=============================================="
echo ""
echo "📦 남은 리소스 확인:"
kubectl get all -n $NAMESPACE 2>/dev/null || echo "리소스 없음"
echo ""

103
deployment/k8s/deploy-all.sh Executable file
View File

@ -0,0 +1,103 @@
#!/bin/bash
# Minikube 백엔드 서비스 원클릭 배포 스크립트
# 작성자: 최운영(데옵스)
# 작성일: 2025-11-29
set -e
NAMESPACE=phonebill
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
echo "=============================================="
echo " PhoneBill Backend - Minikube 배포 시작"
echo "=============================================="
# 1. Kubernetes Context 확인
echo ""
echo "[1/7] Kubernetes Context 확인..."
CURRENT_CONTEXT=$(kubectl config current-context)
echo "현재 Context: $CURRENT_CONTEXT"
if [[ "$CURRENT_CONTEXT" != "minikube-remote" ]]; then
echo "⚠️ 경고: 현재 Context가 minikube-remote가 아닙니다."
read -p "계속 진행하시겠습니까? (y/N): " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
echo "배포를 취소합니다."
exit 1
fi
fi
# 2. Namespace 생성
echo ""
echo "[2/7] Namespace 생성..."
kubectl create namespace $NAMESPACE --dry-run=client -o yaml | kubectl apply -f -
kubectl config set-context --current --namespace=$NAMESPACE
# 3. Secrets 적용
echo ""
echo "[3/7] Secrets 적용..."
kubectl apply -f "$SCRIPT_DIR/secrets/"
# 4. ConfigMaps 적용
echo ""
echo "[4/7] ConfigMaps 적용..."
kubectl apply -f "$SCRIPT_DIR/configmaps/"
# 5. Deployments 적용
echo ""
echo "[5/7] Deployments 적용..."
kubectl apply -f "$SCRIPT_DIR/deployments/"
# 6. Services 적용
echo ""
echo "[6/7] Services 적용..."
kubectl apply -f "$SCRIPT_DIR/services/"
# 7. Ingress 적용
echo ""
echo "[7/7] Ingress 적용..."
kubectl apply -f "$SCRIPT_DIR/ingress/"
# 배포 상태 대기
echo ""
echo "=============================================="
echo " 배포 상태 확인 중..."
echo "=============================================="
for service in api-gateway user-service bill-service product-service kos-mock; do
echo ""
echo "$service 배포 대기 중..."
kubectl rollout status deployment/$service -n $NAMESPACE --timeout=180s || {
echo "$service 배포 실패"
kubectl describe deployment/$service -n $NAMESPACE
exit 1
}
echo "$service 배포 완료"
done
# 최종 상태 출력
echo ""
echo "=============================================="
echo " 배포 완료!"
echo "=============================================="
echo ""
echo "📦 Pods 상태:"
kubectl get pods -n $NAMESPACE
echo ""
echo "🔗 Services:"
kubectl get svc -n $NAMESPACE
echo ""
echo "🌐 Ingress:"
kubectl get ingress -n $NAMESPACE
echo ""
echo "=============================================="
echo " 접속 방법"
echo "=============================================="
echo ""
echo "API Gateway Ingress Host:"
echo " phonebill-api.72.155.72.236.nip.io"
echo ""
echo "Health Check:"
echo " curl http://phonebill-api.72.155.72.236.nip.io/actuator/health"
echo ""

View File

@ -1,313 +0,0 @@
# 통신요금 관리 서비스 백엔드 Kubernetes 배포 가이드
## 📋 배포 개요
**시스템명**: phonebill
**네임스페이스**: phonebill-dev
**ACR명**: acrdigitalgarage01
**k8s명**: aks-digitalgarage-01
**파드수**: 1개 (각 서비스)
**리소스**: CPU 256m/1024m, 메모리 256Mi/1024Mi
## 🎯 배포 대상 서비스
| 서비스명 | 포트 | 엔드포인트 |
|---------|------|-----------|
| api-gateway | 8080 | Gateway 및 라우팅 |
| user-service | 8081 | /api/v1/auth, /api/v1/users |
| bill-service | 8082 | /api/v1/bills |
| product-service | 8083 | /api/v1/products |
| kos-mock | 8084 | /api/v1/kos |
## 📋 배포 전 검증 결과
### ✅ 검증 완료 항목
- 객체이름 네이밍룰 준수
- Secret에서 stringData 사용
- JWT_SECRET 실행 프로파일 값 적용
- Image 경로 올바른 형식
- Service/Ingress 포트 매핑 일치 (80번)
- Controller @RequestMapping 기반 path 설정
- 보안 환경변수 Secret 분리
- REDIS_DATABASE 서비스별 구분 (0,1,2)
- envFrom 사용으로 환경변수 주입
- 실행 프로파일 전체 환경변수 매핑 완료
### ✅ 배포 전 확인 완료 사항
모든 환경 정보가 확인되어 매니페스트 파일에 반영 완료되었습니다:
1. **✅ Ingress Controller External IP**: `20.214.196.128`
2. **✅ ACR 인증 정보**: `acrdigitalgarage01` / 실제 패스워드 적용
3. **✅ Redis Service**: `redis-cache-dev-master`
4. **✅ Database Services**:
- User Service: `auth-postgres-dev-postgresql`
- Bill Service: `bill-inquiry-postgres-dev-postgresql`
- Product Service: `product-change-postgres-dev-postgresql`
## 🔧 사전 확인 방법
### 1. Azure 로그인 상태 확인
```bash
az account show
```
### 2. AKS Credential 확인
```bash
kubectl cluster-info
```
### 3. 네임스페이스 존재 확인
```bash
kubectl get ns phonebill-dev
```
### 4. Ingress Controller External IP 확인 ✅
```bash
kubectl get svc ingress-nginx-controller -n ingress-nginx
```
**확인 완료**: EXTERNAL-IP = `20.214.196.128`
### 5. ACR 인증 정보 확인 ✅
```bash
# USERNAME 확인
USERNAME=$(az acr credential show -n acrdigitalgarage01 --query "username" -o tsv)
echo $USERNAME
# PASSWORD 확인
PASSWORD=$(az acr credential show -n acrdigitalgarage01 --query "passwords[0].value" -o tsv)
echo $PASSWORD
```
**확인 완료**: USERNAME = `acrdigitalgarage01`, PASSWORD = 실제 값 적용
### 6. Redis Service 이름 확인 ✅
```bash
kubectl get svc -n phonebill-dev | grep redis
```
**확인 완료**: `redis-cache-dev-master` (ClusterIP)
### 7. Database Service 이름 확인 ✅
```bash
# 각 서비스별 DB 확인
kubectl get svc -n phonebill-dev | grep auth
kubectl get svc -n phonebill-dev | grep bill
kubectl get svc -n phonebill-dev | grep product
```
**확인 완료**:
- User Service: `auth-postgres-dev-postgresql`
- Bill Service: `bill-inquiry-postgres-dev-postgresql`
- Product Service: `product-change-postgres-dev-postgresql`
## ✅ 매니페스트 업데이트 완료
모든 매니페스트 파일이 실제 환경 정보로 업데이트 완료되었습니다:
### 1. ✅ Ingress External IP 적용
`deployment/k8s/common/ingress.yaml`:
```yaml
host: phonebill-api.20.214.196.128.nip.io
```
### 2. ✅ CORS Origins 적용
`deployment/k8s/common/cm-common.yaml`:
```yaml
CORS_ALLOWED_ORIGINS: "http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill.20.214.196.128.nip.io"
```
### 3. ✅ ACR 인증 정보 적용
`deployment/k8s/common/secret-imagepull.yaml`:
```yaml
stringData:
.dockerconfigjson: |
{
"auths": {
"acrdigitalgarage01.azurecr.io": {
"username": "acrdigitalgarage01",
"password": "+OY+rmOagorjWvQe/tTk6oqvnZI8SmNbY/Y2o5EDcY+ACRDCDbYk",
"auth": "YWNyZGlnaXRhbGdhcmFnZTAxOitPWStybU9hZ29yald2UWUvdFRrNm9xdm5aSThTbU5iWS9ZMm81RURjWStBQ1JEQ0RiWWs="
}
}
}
```
### 4. ✅ Redis Host 적용
`deployment/k8s/common/secret-common.yaml`:
```yaml
REDIS_HOST: "redis-cache-dev-master"
```
### 5. ✅ Database Host 적용
**user-service**: `deployment/k8s/user-service/secret-user-service.yaml`
```yaml
DB_HOST: "auth-postgres-dev-postgresql"
```
**bill-service**: `deployment/k8s/bill-service/secret-bill-service.yaml`
```yaml
DB_HOST: "bill-inquiry-postgres-dev-postgresql"
```
**product-service**: `deployment/k8s/product-service/secret-product-service.yaml`
```yaml
DB_HOST: "product-change-postgres-dev-postgresql"
```
## 🚀 배포 실행 가이드
### 1. 공통 매니페스트 적용
```bash
kubectl apply -f deployment/k8s/common/
```
### 2. 서비스별 매니페스트 적용
```bash
# 각 서비스 순차 적용
kubectl apply -f deployment/k8s/api-gateway/
kubectl apply -f deployment/k8s/user-service/
kubectl apply -f deployment/k8s/bill-service/
kubectl apply -f deployment/k8s/product-service/
kubectl apply -f deployment/k8s/kos-mock/
```
### 3. 배포 상태 확인
#### 전체 객체 확인
```bash
kubectl get all -n phonebill-dev
```
#### Pod 상태 확인
```bash
kubectl get pods -n phonebill-dev
```
#### Service 확인
```bash
kubectl get svc -n phonebill-dev
```
#### Ingress 확인
```bash
kubectl get ingress -n phonebill-dev
```
#### ConfigMap/Secret 확인
```bash
kubectl get cm,secret -n phonebill-dev
```
### 4. 로그 확인
```bash
# 특정 서비스 로그 확인
kubectl logs -f deployment/user-service -n phonebill-dev
kubectl logs -f deployment/bill-service -n phonebill-dev
kubectl logs -f deployment/product-service -n phonebill-dev
kubectl logs -f deployment/api-gateway -n phonebill-dev
kubectl logs -f deployment/kos-mock -n phonebill-dev
```
### 5. Health Check 확인
```bash
# 각 서비스 Health 상태 확인 (Pod 내부에서)
kubectl exec -n phonebill-dev deployment/user-service -- curl http://localhost:8081/actuator/health
kubectl exec -n phonebill-dev deployment/bill-service -- curl http://localhost:8082/actuator/health
kubectl exec -n phonebill-dev deployment/product-service -- curl http://localhost:8083/actuator/health
```
## 🔍 문제 해결 가이드
### Pod 시작 실패시
```bash
# Pod 상세 정보 확인
kubectl describe pod <POD_NAME> -n phonebill-dev
# 이벤트 확인
kubectl get events -n phonebill-dev --sort-by='.lastTimestamp'
```
### ConfigMap/Secret 변경시
```bash
# 변경 후 Pod 재시작
kubectl rollout restart deployment/<SERVICE_NAME> -n phonebill-dev
```
### 네트워크 연결 문제
```bash
# Service DNS 해결 테스트
kubectl exec -n phonebill-dev deployment/api-gateway -- nslookup user-service
```
## 📊 환경변수 매핑 테이블
| 서비스명 | 환경변수 | 지정 객체명 | 환경변수값 |
|---------|---------|-----------|-----------|
| api-gateway | SERVER_PORT | cm-api-gateway | 8080 |
| api-gateway | BILL_SERVICE_URL | cm-api-gateway | http://bill-service |
| api-gateway | PRODUCT_SERVICE_URL | cm-api-gateway | http://product-service |
| api-gateway | USER_SERVICE_URL | cm-api-gateway | http://user-service |
| api-gateway | KOS_MOCK_URL | cm-api-gateway | http://kos-mock |
| 공통 | CORS_ALLOWED_ORIGINS | cm-common | http://localhost:8081,http://localhost:8082,http://localhost:8083,http://localhost:8084,http://phonebill.{EXTERNAL_IP}.nip.io |
| 공통 | JWT_ACCESS_TOKEN_VALIDITY | cm-common | 18000000 |
| 공통 | JWT_REFRESH_TOKEN_VALIDITY | cm-common | 86400000 |
| 공통 | JWT_SECRET | secret-common | (base64 encoded JWT secret) |
| 공통 | REDIS_HOST | secret-common | (Redis 서비스명) |
| 공통 | REDIS_PASSWORD | secret-common | Redis2025Dev! |
| 공통 | REDIS_PORT | cm-common | 6379 |
| 공통 | SPRING_PROFILES_ACTIVE | cm-common | dev |
| user-service | SERVER_PORT | cm-user-service | 8081 |
| user-service | DB_KIND | cm-user-service | postgresql |
| user-service | DB_PORT | cm-user-service | 5432 |
| user-service | DDL_AUTO | cm-user-service | update |
| user-service | REDIS_DATABASE | cm-user-service | 0 |
| user-service | SHOW_SQL | cm-user-service | true |
| user-service | DB_HOST | secret-user-service | (Auth DB 서비스명) |
| user-service | DB_NAME | secret-user-service | phonebill_auth |
| user-service | DB_USERNAME | secret-user-service | auth_user |
| user-service | DB_PASSWORD | secret-user-service | AuthUser2025! |
| bill-service | SERVER_PORT | cm-bill-service | 8082 |
| bill-service | DB_KIND | cm-bill-service | postgresql |
| bill-service | DB_PORT | cm-bill-service | 5432 |
| bill-service | DB_CONNECTION_TIMEOUT | cm-bill-service | 30000 |
| bill-service | DB_IDLE_TIMEOUT | cm-bill-service | 600000 |
| bill-service | DB_LEAK_DETECTION | cm-bill-service | 60000 |
| bill-service | DB_MAX_LIFETIME | cm-bill-service | 1800000 |
| bill-service | DB_MAX_POOL | cm-bill-service | 20 |
| bill-service | DB_MIN_IDLE | cm-bill-service | 5 |
| bill-service | KOS_BASE_URL | cm-bill-service | http://kos-mock |
| bill-service | LOG_FILE_NAME | cm-bill-service | logs/bill-service.log |
| bill-service | REDIS_DATABASE | cm-bill-service | 1 |
| bill-service | REDIS_MAX_ACTIVE | cm-bill-service | 8 |
| bill-service | REDIS_MAX_IDLE | cm-bill-service | 8 |
| bill-service | REDIS_MAX_WAIT | cm-bill-service | -1 |
| bill-service | REDIS_MIN_IDLE | cm-bill-service | 0 |
| bill-service | REDIS_TIMEOUT | cm-bill-service | 2000 |
| bill-service | DB_HOST | secret-bill-service | (Bill DB 서비스명) |
| bill-service | DB_NAME | secret-bill-service | bill_inquiry_db |
| bill-service | DB_USERNAME | secret-bill-service | bill_inquiry_user |
| bill-service | DB_PASSWORD | secret-bill-service | BillUser2025! |
| product-service | SERVER_PORT | cm-product-service | 8083 |
| product-service | DB_KIND | cm-product-service | postgresql |
| product-service | DB_PORT | cm-product-service | 5432 |
| product-service | DDL_AUTO | cm-product-service | update |
| product-service | KOS_BASE_URL | cm-product-service | http://kos-mock |
| product-service | KOS_CLIENT_ID | cm-product-service | product-service-dev |
| product-service | KOS_MOCK_ENABLED | cm-product-service | true |
| product-service | REDIS_DATABASE | cm-product-service | 2 |
| product-service | DB_HOST | secret-product-service | (Product DB 서비스명) |
| product-service | DB_NAME | secret-product-service | product_change_db |
| product-service | DB_USERNAME | secret-product-service | product_change_user |
| product-service | DB_PASSWORD | secret-product-service | ProductUser2025! |
| product-service | KOS_API_KEY | secret-product-service | dev-api-key |
| kos-mock | SERVER_PORT | cm-kos-mock | 8084 |
## 🎯 배포 완료 후 접근 URL
- **API Gateway**: http://phonebill-api.20.214.196.128.nip.io
- **Swagger UI**: http://phonebill-api.20.214.196.128.nip.io/swagger-ui/index.html
- **사용자 인증**: http://phonebill-api.20.214.196.128.nip.io/api/v1/auth
- **요금 조회**: http://phonebill-api.20.214.196.128.nip.io/api/v1/bills
- **상품 변경**: http://phonebill-api.20.214.196.128.nip.io/api/v1/products
---
**✅ 배포 준비 완료**: 모든 환경 정보가 확인되어 매니페스트 파일에 반영되었습니다. 이제 바로 배포를 진행할 수 있습니다.

View File

@ -0,0 +1,867 @@
# Minikube 백엔드 서비스 배포 가이드
## 개요
본 문서는 phonebill 프로젝트의 백엔드 마이크로서비스들을 Minikube 환경에 배포하는 방법을 설명합니다.
## 배포 대상 서비스
| 서비스명 | 포트 | 설명 |
|---------|------|------|
| api-gateway | 8080 | API Gateway 서비스 |
| user-service | 8081 | 사용자 인증/관리 서비스 |
| bill-service | 8082 | 요금 조회 서비스 |
| product-service | 8083 | 상품 변경 서비스 |
| kos-mock | 8084 | KOS 목업 서비스 |
## 배포 환경 정보
| 항목 | 값 |
|------|-----|
| Image Registry | docker.io |
| Image Organization | hiondal |
| Kubernetes Context | minikube-remote |
| Namespace | phonebill |
| Replicas | 1 |
| CPU Request/Limit | 256m/1024m |
| Memory Request/Limit | 256Mi/1024Mi |
---
## 사전 준비
### 1. Minikube 상태 확인
```bash
# context 전환
kubectl config use-context minikube-remote
# minikube 상태 확인
minikube status
# 노드 확인
kubectl get nodes
```
### 2. Namespace 생성
```bash
kubectl create namespace phonebill
kubectl config set-context --current --namespace=phonebill
```
### 3. Ingress Controller 활성화
```bash
minikube addons enable ingress
```
### 4. 백킹 서비스 확인
배포 전 PostgreSQL과 Redis가 실행 중인지 확인합니다:
```bash
# PostgreSQL 파드 확인
kubectl get pods -n phonebill | grep postgres
# Redis 파드 확인
kubectl get pods -n phonebill | grep redis
```
---
## Step 1: 컨테이너 이미지 빌드 및 푸시
### 1.1 Gradle 빌드
```bash
cd /Users/dreamondal/home/workspace/phonebill
./gradlew clean build -x test
```
### 1.2 Docker 이미지 빌드
```bash
DOCKER_FILE=deployment/container/Dockerfile-backend
REGISTRY=docker.io
PROJECT=hiondal
TAG=latest
# 각 서비스 이미지 빌드
for service in api-gateway user-service bill-service product-service kos-mock; do
docker build \
--platform linux/amd64 \
--build-arg BUILD_LIB_DIR="${service}/build/libs" \
--build-arg ARTIFACTORY_FILE="${service}.jar" \
-f ${DOCKER_FILE} \
-t ${REGISTRY}/${PROJECT}/${service}:${TAG} .
done
```
### 1.3 Docker Hub 푸시
```bash
# Docker Hub 로그인
docker login
# 이미지 푸시
for service in api-gateway user-service bill-service product-service kos-mock; do
docker push ${REGISTRY}/${PROJECT}/${service}:${TAG}
done
```
---
## Step 2: Secret 생성
### 2.1 공통 Secret (JWT, Redis)
```bash
kubectl create secret generic phonebill-common-secret \
--namespace=phonebill \
--from-literal=JWT_SECRET='your-jwt-secret-key-must-be-at-least-256-bits-long-for-hs256' \
--from-literal=REDIS_PASSWORD=''
```
### 2.2 서비스별 DB Secret
```bash
# user-service DB Secret
kubectl create secret generic user-service-db-secret \
--namespace=phonebill \
--from-literal=DB_USERNAME='postgres' \
--from-literal=DB_PASSWORD='your-auth-db-password'
# bill-service DB Secret
kubectl create secret generic bill-service-db-secret \
--namespace=phonebill \
--from-literal=DB_USERNAME='postgres' \
--from-literal=DB_PASSWORD='your-bill-db-password'
# product-service DB Secret
kubectl create secret generic product-service-db-secret \
--namespace=phonebill \
--from-literal=DB_USERNAME='postgres' \
--from-literal=DB_PASSWORD='your-product-db-password'
```
---
## Step 3: ConfigMap 생성
### 3.1 공통 ConfigMap
```bash
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: phonebill-common-config
namespace: phonebill
data:
SPRING_PROFILES_ACTIVE: "prod"
REDIS_HOST: "redis-cache.phonebill.svc.cluster.local"
REDIS_PORT: "6379"
CORS_ALLOWED_ORIGINS: "*"
SHOW_SQL: "false"
DDL_AUTO: "none"
EOF
```
### 3.2 서비스별 ConfigMap
```bash
# API Gateway ConfigMap
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: api-gateway-config
namespace: phonebill
data:
SERVER_PORT: "8080"
USER_SERVICE_URL: "http://user-service:8081"
BILL_SERVICE_URL: "http://bill-service:8082"
PRODUCT_SERVICE_URL: "http://product-service:8083"
KOS_MOCK_URL: "http://kos-mock:8084"
EOF
# User Service ConfigMap
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: user-service-config
namespace: phonebill
data:
SERVER_PORT: "8081"
DB_HOST: "auth-postgres.phonebill.svc.cluster.local"
DB_PORT: "5432"
DB_NAME: "phonebill_auth"
REDIS_DATABASE: "0"
EOF
# Bill Service ConfigMap
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: bill-service-config
namespace: phonebill
data:
SERVER_PORT: "8082"
DB_HOST: "bill-inquiry-postgres.phonebill.svc.cluster.local"
DB_PORT: "5432"
DB_NAME: "bill_inquiry"
REDIS_DATABASE: "1"
KOS_BASE_URL: "http://kos-mock:8084"
EOF
# Product Service ConfigMap
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: product-service-config
namespace: phonebill
data:
SERVER_PORT: "8083"
DB_HOST: "product-change-postgres.phonebill.svc.cluster.local"
DB_PORT: "5432"
DB_NAME: "product_change"
REDIS_DATABASE: "2"
KOS_BASE_URL: "http://kos-mock:8084"
EOF
# KOS Mock ConfigMap
kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: kos-mock-config
namespace: phonebill
data:
SERVER_PORT: "8084"
EOF
```
---
## Step 4: Deployment 생성
### 4.1 API Gateway Deployment
```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: api-gateway
namespace: phonebill
labels:
app: api-gateway
spec:
replicas: 1
selector:
matchLabels:
app: api-gateway
template:
metadata:
labels:
app: api-gateway
spec:
containers:
- name: api-gateway
image: docker.io/hiondal/api-gateway:latest
imagePullPolicy: Always
ports:
- containerPort: 8080
envFrom:
- configMapRef:
name: phonebill-common-config
- configMapRef:
name: api-gateway-config
- secretRef:
name: phonebill-common-secret
resources:
requests:
cpu: "256m"
memory: "256Mi"
limits:
cpu: "1024m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8080
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
EOF
```
### 4.2 User Service Deployment
```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: user-service
namespace: phonebill
labels:
app: user-service
spec:
replicas: 1
selector:
matchLabels:
app: user-service
template:
metadata:
labels:
app: user-service
spec:
containers:
- name: user-service
image: docker.io/hiondal/user-service:latest
imagePullPolicy: Always
ports:
- containerPort: 8081
envFrom:
- configMapRef:
name: phonebill-common-config
- configMapRef:
name: user-service-config
- secretRef:
name: phonebill-common-secret
- secretRef:
name: user-service-db-secret
resources:
requests:
cpu: "256m"
memory: "256Mi"
limits:
cpu: "1024m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8081
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8081
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
EOF
```
### 4.3 Bill Service Deployment
```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: bill-service
namespace: phonebill
labels:
app: bill-service
spec:
replicas: 1
selector:
matchLabels:
app: bill-service
template:
metadata:
labels:
app: bill-service
spec:
containers:
- name: bill-service
image: docker.io/hiondal/bill-service:latest
imagePullPolicy: Always
ports:
- containerPort: 8082
envFrom:
- configMapRef:
name: phonebill-common-config
- configMapRef:
name: bill-service-config
- secretRef:
name: phonebill-common-secret
- secretRef:
name: bill-service-db-secret
resources:
requests:
cpu: "256m"
memory: "256Mi"
limits:
cpu: "1024m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8082
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8082
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
EOF
```
### 4.4 Product Service Deployment
```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: product-service
namespace: phonebill
labels:
app: product-service
spec:
replicas: 1
selector:
matchLabels:
app: product-service
template:
metadata:
labels:
app: product-service
spec:
containers:
- name: product-service
image: docker.io/hiondal/product-service:latest
imagePullPolicy: Always
ports:
- containerPort: 8083
envFrom:
- configMapRef:
name: phonebill-common-config
- configMapRef:
name: product-service-config
- secretRef:
name: phonebill-common-secret
- secretRef:
name: product-service-db-secret
resources:
requests:
cpu: "256m"
memory: "256Mi"
limits:
cpu: "1024m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8083
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8083
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
EOF
```
### 4.5 KOS Mock Deployment
```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: kos-mock
namespace: phonebill
labels:
app: kos-mock
spec:
replicas: 1
selector:
matchLabels:
app: kos-mock
template:
metadata:
labels:
app: kos-mock
spec:
containers:
- name: kos-mock
image: docker.io/hiondal/kos-mock:latest
imagePullPolicy: Always
ports:
- containerPort: 8084
envFrom:
- configMapRef:
name: phonebill-common-config
- configMapRef:
name: kos-mock-config
- secretRef:
name: phonebill-common-secret
resources:
requests:
cpu: "256m"
memory: "256Mi"
limits:
cpu: "1024m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8084
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8084
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
EOF
```
---
## Step 5: Service 생성
```bash
# API Gateway Service
kubectl apply -f - <<EOF
apiVersion: v1
kind: Service
metadata:
name: api-gateway
namespace: phonebill
spec:
type: ClusterIP
selector:
app: api-gateway
ports:
- port: 8080
targetPort: 8080
protocol: TCP
EOF
# User Service
kubectl apply -f - <<EOF
apiVersion: v1
kind: Service
metadata:
name: user-service
namespace: phonebill
spec:
type: ClusterIP
selector:
app: user-service
ports:
- port: 8081
targetPort: 8081
protocol: TCP
EOF
# Bill Service
kubectl apply -f - <<EOF
apiVersion: v1
kind: Service
metadata:
name: bill-service
namespace: phonebill
spec:
type: ClusterIP
selector:
app: bill-service
ports:
- port: 8082
targetPort: 8082
protocol: TCP
EOF
# Product Service
kubectl apply -f - <<EOF
apiVersion: v1
kind: Service
metadata:
name: product-service
namespace: phonebill
spec:
type: ClusterIP
selector:
app: product-service
ports:
- port: 8083
targetPort: 8083
protocol: TCP
EOF
# KOS Mock Service
kubectl apply -f - <<EOF
apiVersion: v1
kind: Service
metadata:
name: kos-mock
namespace: phonebill
spec:
type: ClusterIP
selector:
app: kos-mock
ports:
- port: 8084
targetPort: 8084
protocol: TCP
EOF
```
---
## Step 6: Ingress 생성
```bash
kubectl apply -f - <<EOF
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: phonebill-ingress
namespace: phonebill
annotations:
nginx.ingress.kubernetes.io/rewrite-target: /\$1
nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
spec:
ingressClassName: nginx
rules:
- host: phonebill-api.72.155.72.236.nip.io
http:
paths:
- path: /(.*)
pathType: ImplementationSpecific
backend:
service:
name: api-gateway
port:
number: 8080
EOF
```
> **참고**: nip.io 도메인을 사용하므로 별도의 hosts 파일 설정이 필요하지 않습니다.
---
## Step 7: 배포 확인
### 7.1 파드 상태 확인
```bash
kubectl get pods -n phonebill -w
```
### 7.2 로그 확인
```bash
# 각 서비스 로그 확인
kubectl logs -f deployment/api-gateway -n phonebill
kubectl logs -f deployment/user-service -n phonebill
kubectl logs -f deployment/bill-service -n phonebill
kubectl logs -f deployment/product-service -n phonebill
kubectl logs -f deployment/kos-mock -n phonebill
```
### 7.3 서비스 엔드포인트 확인
```bash
kubectl get endpoints -n phonebill
```
### 7.4 Ingress 상태 확인
```bash
kubectl get ingress -n phonebill
```
---
## Step 8: API 테스트
### 8.1 Health Check
```bash
# API Gateway Health Check
curl http://phonebill-api.72.155.72.236.nip.io/actuator/health
```
### 8.2 서비스 API 테스트
```bash
# 사용자 등록 API
curl -X POST http://phonebill-api.72.155.72.236.nip.io/api/users/register \
-H "Content-Type: application/json" \
-d '{
"userId": "testuser",
"password": "Test1234!",
"name": "테스트사용자",
"email": "test@example.com",
"phoneNumber": "01012345678"
}'
# 로그인 API
curl -X POST http://phonebill-api.72.155.72.236.nip.io/api/users/login \
-H "Content-Type: application/json" \
-d '{
"userId": "testuser",
"password": "Test1234!"
}'
```
---
## 트러블슈팅
### 파드가 시작되지 않는 경우
```bash
# 파드 상세 정보 확인
kubectl describe pod <pod-name> -n phonebill
# 이벤트 확인
kubectl get events -n phonebill --sort-by='.lastTimestamp'
```
### 이미지 풀 실패
```bash
# Docker Hub 인증 Secret 생성 (필요시)
kubectl create secret docker-registry regcred \
--namespace=phonebill \
--docker-server=https://index.docker.io/v1/ \
--docker-username=<username> \
--docker-password=<password> \
--docker-email=<email>
# Deployment에 imagePullSecrets 추가
kubectl patch deployment <deployment-name> -n phonebill \
-p '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"regcred"}]}}}}'
```
### DB 연결 실패
```bash
# PostgreSQL 서비스 확인
kubectl get svc -n phonebill | grep postgres
# DNS 해석 테스트
kubectl run -it --rm debug --image=busybox --restart=Never -n phonebill \
-- nslookup auth-postgres.phonebill.svc.cluster.local
```
### Redis 연결 실패
```bash
# Redis 서비스 확인
kubectl get svc -n phonebill | grep redis
# Redis 연결 테스트
kubectl run -it --rm redis-cli --image=redis:alpine --restart=Never -n phonebill \
-- redis-cli -h redis-cache.phonebill.svc.cluster.local ping
```
---
## 리소스 정리
### 전체 삭제
```bash
kubectl delete namespace phonebill
```
### 개별 삭제
```bash
# Ingress 삭제
kubectl delete ingress phonebill-ingress -n phonebill
# 서비스 삭제
kubectl delete svc api-gateway user-service bill-service product-service kos-mock -n phonebill
# Deployment 삭제
kubectl delete deployment api-gateway user-service bill-service product-service kos-mock -n phonebill
# ConfigMap 삭제
kubectl delete configmap phonebill-common-config api-gateway-config user-service-config \
bill-service-config product-service-config kos-mock-config -n phonebill
# Secret 삭제
kubectl delete secret phonebill-common-secret user-service-db-secret \
bill-service-db-secret product-service-db-secret -n phonebill
```
---
## 원클릭 배포 스크립트
전체 배포를 한 번에 수행하는 스크립트:
```bash
#!/bin/bash
# deploy-all.sh
NAMESPACE=phonebill
REGISTRY=docker.io
PROJECT=hiondal
TAG=latest
echo "=== Minikube Backend 배포 시작 ==="
# 1. Namespace 생성
kubectl create namespace $NAMESPACE --dry-run=client -o yaml | kubectl apply -f -
# 2. Secrets 생성
echo "Creating secrets..."
kubectl create secret generic phonebill-common-secret \
--namespace=$NAMESPACE \
--from-literal=JWT_SECRET='your-jwt-secret-key-must-be-at-least-256-bits-long-for-hs256' \
--from-literal=REDIS_PASSWORD='' \
--dry-run=client -o yaml | kubectl apply -f -
# 3. ConfigMaps 적용
echo "Applying ConfigMaps..."
kubectl apply -f deployment/k8s/configmaps/
# 4. Deployments 적용
echo "Applying Deployments..."
kubectl apply -f deployment/k8s/deployments/
# 5. Services 적용
echo "Applying Services..."
kubectl apply -f deployment/k8s/services/
# 6. Ingress 적용
echo "Applying Ingress..."
kubectl apply -f deployment/k8s/ingress/
# 7. 배포 상태 확인
echo "Waiting for deployments..."
kubectl rollout status deployment/api-gateway -n $NAMESPACE --timeout=120s
kubectl rollout status deployment/user-service -n $NAMESPACE --timeout=120s
kubectl rollout status deployment/bill-service -n $NAMESPACE --timeout=120s
kubectl rollout status deployment/product-service -n $NAMESPACE --timeout=120s
kubectl rollout status deployment/kos-mock -n $NAMESPACE --timeout=120s
echo "=== 배포 완료 ==="
kubectl get pods -n $NAMESPACE
```
---
## 작성자
- **작성자**: 최운영(데옵스)
- **작성일**: 2025-11-29
- **버전**: 1.0.0

View File

@ -2,6 +2,10 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: api-gateway name: api-gateway
namespace: phonebill
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,46 +16,40 @@ spec:
labels: labels:
app: api-gateway app: api-gateway
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: api-gateway - name: api-gateway
image: acrdigitalgarage01.azurecr.io/phonebill/api-gateway:latest image: docker.io/hiondal/api-gateway:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8080 - containerPort: 8080
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: phonebill-common-config
- configMapRef: - configMapRef:
name: cm-api-gateway name: api-gateway-config
- secretRef: - secretRef:
name: secret-common name: phonebill-common-secret
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /health path: /actuator/health/liveness
port: 8080
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080 port: 8080
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,6 +2,10 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: bill-service name: bill-service
namespace: phonebill
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,48 +16,42 @@ spec:
labels: labels:
app: bill-service app: bill-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: bill-service - name: bill-service
image: acrdigitalgarage01.azurecr.io/phonebill/bill-service:latest image: docker.io/hiondal/bill-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8082 - containerPort: 8082
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: phonebill-common-config
- configMapRef: - configMapRef:
name: cm-bill-service name: bill-service-config
- secretRef: - secretRef:
name: secret-common name: phonebill-common-secret
- secretRef: - secretRef:
name: secret-bill-service name: bill-service-db-secret
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8082
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8082
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8082 port: 8082
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8082
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,6 +2,10 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: kos-mock name: kos-mock
namespace: phonebill
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,46 +16,40 @@ spec:
labels: labels:
app: kos-mock app: kos-mock
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: kos-mock - name: kos-mock
image: acrdigitalgarage01.azurecr.io/phonebill/kos-mock:latest image: docker.io/hiondal/kos-mock:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8084 - containerPort: 8084
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: phonebill-common-config
- configMapRef: - configMapRef:
name: cm-kos-mock name: kos-mock-config
- secretRef: - secretRef:
name: secret-common name: phonebill-common-secret
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8084
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8084
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8084 port: 8084
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8084
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,6 +2,10 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: product-service name: product-service
namespace: phonebill
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,48 +16,42 @@ spec:
labels: labels:
app: product-service app: product-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: product-service - name: product-service
image: acrdigitalgarage01.azurecr.io/phonebill/product-service:latest image: docker.io/hiondal/product-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8083 - containerPort: 8083
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: phonebill-common-config
- configMapRef: - configMapRef:
name: cm-product-service name: product-service-config
- secretRef: - secretRef:
name: secret-common name: phonebill-common-secret
- secretRef: - secretRef:
name: secret-product-service name: product-service-db-secret
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8083
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8083
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8083 port: 8083
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8083
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -2,6 +2,10 @@ apiVersion: apps/v1
kind: Deployment kind: Deployment
metadata: metadata:
name: user-service name: user-service
namespace: phonebill
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
spec: spec:
replicas: 1 replicas: 1
selector: selector:
@ -12,48 +16,42 @@ spec:
labels: labels:
app: user-service app: user-service
spec: spec:
imagePullSecrets:
- name: phonebill
containers: containers:
- name: user-service - name: user-service
image: acrdigitalgarage01.azurecr.io/phonebill/user-service:latest image: docker.io/hiondal/user-service:latest
imagePullPolicy: Always imagePullPolicy: Always
ports: ports:
- containerPort: 8081 - containerPort: 8081
name: http
envFrom: envFrom:
- configMapRef: - configMapRef:
name: cm-common name: phonebill-common-config
- configMapRef: - configMapRef:
name: cm-user-service name: user-service-config
- secretRef: - secretRef:
name: secret-common name: phonebill-common-secret
- secretRef: - secretRef:
name: secret-user-service name: user-service-db-secret
resources: resources:
requests: requests:
cpu: 256m cpu: "256m"
memory: 256Mi memory: "256Mi"
limits: limits:
cpu: 1024m cpu: "1024m"
memory: 1024Mi memory: "1024Mi"
startupProbe:
httpGet:
path: /actuator/health
port: 8081
initialDelaySeconds: 30
periodSeconds: 10
failureThreshold: 6
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8081
initialDelaySeconds: 10
periodSeconds: 5
failureThreshold: 3
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /actuator/health/liveness path: /actuator/health/liveness
port: 8081 port: 8081
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8081
initialDelaySeconds: 30 initialDelaySeconds: 30
periodSeconds: 10 periodSeconds: 10
failureThreshold: 3 timeoutSeconds: 5
failureThreshold: 3

View File

@ -0,0 +1,25 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: phonebill-ingress
namespace: phonebill
labels:
app.kubernetes.io/part-of: phonebill
annotations:
nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
spec:
ingressClassName: nginx
rules:
- host: phonebill-api.72.155.72.236.nip.io
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: api-gateway
port:
number: 8080

View File

@ -1,6 +0,0 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-kos-mock
data:
SERVER_PORT: "8084"

View File

@ -1,11 +0,0 @@
apiVersion: v1
kind: Service
metadata:
name: kos-mock
spec:
selector:
app: kos-mock
ports:
- port: 80
targetPort: 8084
type: ClusterIP

View File

@ -1,10 +0,0 @@
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-product-service
data:
SERVER_PORT: "8083"
DB_KIND: "postgresql"
DB_PORT: "5432"
KOS_BASE_URL: "http://kos-mock"
REDIS_DATABASE: "2"

View File

@ -1,10 +0,0 @@
apiVersion: v1
kind: Secret
metadata:
name: secret-product-service
type: Opaque
stringData:
DB_HOST: "product-change-postgres-dev-postgresql"
DB_NAME: "product_change_db"
DB_USERNAME: "product_change_user"
DB_PASSWORD: "ProductUser2025@"

View File

@ -1,11 +0,0 @@
apiVersion: v1
kind: Service
metadata:
name: product-service
spec:
selector:
app: product-service
ports:
- port: 80
targetPort: 8083
type: ClusterIP

View File

@ -0,0 +1,12 @@
apiVersion: v1
kind: Secret
metadata:
name: bill-service-db-secret
namespace: phonebill
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
type: Opaque
stringData:
DB_USERNAME: "unicorn"
DB_PASSWORD: "P@ssw0rd$"

View File

@ -0,0 +1,13 @@
apiVersion: v1
kind: Secret
metadata:
name: phonebill-common-secret
namespace: phonebill
labels:
app.kubernetes.io/part-of: phonebill
type: Opaque
stringData:
# JWT Secret (최소 256비트 이상, HS256 알고리즘용)
JWT_SECRET: "EK1ZV7vROOXREXbYe/BCISdQq0Yklk9JtoA2v88ux1DBDc0bDGiRRxHeDSb7GHkDP9IUYHMVsBi4/1rS4OhfRg=="
# Redis 비밀번호 (비밀번호 없는 경우 빈 값)
REDIS_PASSWORD: "P@ssw0rd$"

View File

@ -0,0 +1,12 @@
apiVersion: v1
kind: Secret
metadata:
name: product-service-db-secret
namespace: phonebill
labels:
app: product-service
app.kubernetes.io/part-of: phonebill
type: Opaque
stringData:
DB_USERNAME: "unicorn"
DB_PASSWORD: "P@ssw0rd$"

View File

@ -0,0 +1,12 @@
apiVersion: v1
kind: Secret
metadata:
name: user-service-db-secret
namespace: phonebill
labels:
app: user-service
app.kubernetes.io/part-of: phonebill
type: Opaque
stringData:
DB_USERNAME: "unicorn"
DB_PASSWORD: "P@ssw0rd$"

View File

@ -2,10 +2,16 @@ apiVersion: v1
kind: Service kind: Service
metadata: metadata:
name: api-gateway name: api-gateway
namespace: phonebill
labels:
app: api-gateway
app.kubernetes.io/part-of: phonebill
spec: spec:
type: ClusterIP
selector: selector:
app: api-gateway app: api-gateway
ports: ports:
- port: 80 - name: http
port: 8080
targetPort: 8080 targetPort: 8080
type: ClusterIP protocol: TCP

View File

@ -0,0 +1,17 @@
apiVersion: v1
kind: Service
metadata:
name: bill-service
namespace: phonebill
labels:
app: bill-service
app.kubernetes.io/part-of: phonebill
spec:
type: ClusterIP
selector:
app: bill-service
ports:
- name: http
port: 8082
targetPort: 8082
protocol: TCP

View File

@ -0,0 +1,17 @@
apiVersion: v1
kind: Service
metadata:
name: kos-mock
namespace: phonebill
labels:
app: kos-mock
app.kubernetes.io/part-of: phonebill
spec:
type: ClusterIP
selector:
app: kos-mock
ports:
- name: http
port: 8084
targetPort: 8084
protocol: TCP

Some files were not shown because too many files have changed in this diff Show More