레이싱 매치 백엔드 GitOps 배포 문서
Jenkins CI와 ArgoCD를 연계한 Kubernetes 배포 매니페스트를 Kustomize로 관리하는 GitOps 저장소
개요
racing-match-backend 서비스의 Kubernetes 배포 설정을 별도 저장소로 분리해 관리하는 GitOps 문서 레포지토리입니다. Jenkinsfile을 통해 CI 파이프라인에서 컨테이너 이미지를 빌드하고 레지스트리에 push한 뒤, Kustomize 기반의 base/overlays 구조로 환경별 배포 설정을 정의합니다. 이미지 태그 변경 사항이 overlay에 커밋되면 ArgoCD가 이를 감지해 클러스터에 자동으로 동기화(sync)하는 흐름을 갖습니다. 애플리케이션 코드와 배포 설정을 분리함으로써 배포 이력 추적과 롤백을 코드 저장소와 독립적으로 관리할 수 있도록 구성했습니다.
담당 역할
Jenkinsfile 및 Kustomize base/overlays 구조를 설계하고, CI에서 ArgoCD sync까지 이어지는 GitOps 배포 파이프라인을 구축했습니다.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
GitOps 배포 흐름
CI에서 이미지가 push된 후 overlay 커밋을 거쳐 ArgoCD가 클러스터에 동기화하는 전체 흐름을 보여줍니다.
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
DevOps
인프라
- Kubernetes애플리케이션이 배포되는 컨테이너 오케스트레이션 대상 플랫폼
핵심 포인트
- 코드 저장소와 배포 매니페스트 저장소를 분리한 GitOps 구조
- Kustomize base/overlays로 환경별 설정 차이를 최소화
- CI에서 이미지 push 후 overlay 커밋으로 배포를 트리거하는 자동화 흐름
문제와 해결
문제환경마다 달라지는 배포 설정을 중복 없이 관리해야 함
해결Kustomize의 base/overlays 구조로 공통 설정과 환경별 설정을 분리
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.