멀티체인 크론 스케줄러 배포 구조 문서
체인별 폴더 구조와 Kustomize base/overlays로 크론 스케줄러를 Jenkins-ArgoCD GitOps 흐름으로 배포하는 구조를 정리한 문서
개요
체인(서비스) 컨텍스트별로 분리된 폴더 아래에서 크론 스케줄러 워크로드를 배포하는 구조를 관찰하고 정리한 문서 레포지토리입니다. 각 체인 폴더에는 Jenkinsfile과 infra/k8s(Kustomize base+overlays)가 위치하며, Jenkins가 이미지를 빌드·push하고 이미지 태그와 overlay 값을 레포에 커밋하면 ArgoCD가 이를 클러스터에 동기화하는 GitOps 흐름을 따릅니다. 스케줄러는 수수료 정산, 잔여 상태 초기화, 이벤트 재처리 등 체인 컨텍스트에 종속된 배치성 작업을 수행하며, CronJob 또는 @nestjs/schedule 기반 Deployment 형태로 실행됩니다. 다중 체인으로 확장할 때는 동일한 패턴의 폴더를 추가하는 방식으로 구조가 재사용됩니다.
담당 역할
체인별 스케줄러 배포 구조와 Jenkins-ArgoCD GitOps 파이프라인 흐름을 조사하여 문서로 정리함.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
GitOps 기반 스케줄러 배포 흐름
Jenkins에서 ArgoCD를 거쳐 클러스터에 스케줄러가 배포되기까지의 전체 흐름을 보여줍니다.
체인별 Kustomize 디렉터리 구조
체인 이름을 딴 폴더 아래에 Jenkinsfile과 Kustomize base/overlays가 배치되는 구조를 보여줍니다.
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
DevOps
인프라
- KubernetesCronJob 또는 Deployment 형태로 스케줄러 워크로드를 실행
도구
- Kustomizebase와 환경별 overlays 구조로 배포 설정을 분리 관리
프레임워크
- NestJS@nestjs/schedule 기반으로 스케줄러 로직을 구현
핵심 포인트
- 체인/서비스 컨텍스트별 폴더로 분리해 다중 체인 확장 시 폴더 추가만으로 패턴을 재사용
- Kustomize base+overlays 구조로 환경별 배포 설정을 분리 관리
- Jenkins 빌드 후 이미지 태그를 레포에 커밋하면 ArgoCD가 자동 동기화하는 GitOps 흐름
- 수수료 정산, 상태 초기화, 이벤트 재처리 등 체인 종속적 배치 작업을 스케줄러로 분리 운영
문제와 해결
문제스케줄러 워크로드의 리소스 요청량을 낮게 유지하면서도 실패 시 안정성을 확보해야 함
해결overlay 레벨에서 재시도 및 알람 정책을 별도로 조정해 리소스 절감과 안정성을 함께 확보
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.