멀티체인 마이크로서비스 GitOps 배포 구성 문서
ArgoCD 부트스트랩부터 10+ 서비스의 환경·체인별 시크릿 관리까지 정리한 GitOps 배포 구성 관찰 문서
개요
여러 마이크로서비스(marketplace, scheduler, launchpad, worker, indexer, raffle, ums 등)로 구성된 백엔드 스택의 배포 구성을 관찰하고 정리한 문서 리포지토리입니다. infra/argocd 아래에 ArgoCD 자체 설치 매니페스트와 base/overlays 구조를 두어 클러스터의 GitOps 컨트롤 플레인 부트스트랩과 애플리케이션 배포를 함께 다룹니다. secrets 디렉터리는 서비스별로 klaytn/polygon/ethereum 같은 체인과 dev/qa/prod 환경 조합에 따라 세분화되어 있으며, sealed-secret·SOPS·SSM 참조 등 암호화된 형태로 시크릿을 저장하는 컨벤션을 확인할 수 있습니다. 새 서비스가 추가될 때는 secrets/<service>/<chain>/<env> 디렉터리 스캐폴딩만 늘리면 되는 구조로, 하나의 조직 내 다수 서비스의 배포 설정을 중앙 집중식으로 관리하는 패턴을 보여줍니다.
담당 역할
기존 배포 구성 리포지토리의 구조를 관찰·분석하여 GitOps 배포 흐름과 시크릿 관리 컨벤션을 문서로 정리.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
GitOps 배포 아키텍처
ArgoCD 부트스트랩부터 서비스별 시크릿 매니페스트가 동기화되는 전체 흐름을 보여줍니다.
신규 서비스 온보딩 흐름
새로운 서비스를 추가할 때 시크릿 디렉터리를 스캐폴딩하고 ArgoCD가 이를 배포하기까지의 절차입니다.
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
인프라
- Kubernetes매니페스트 기반으로 배포되는 대상 플랫폼
- AWS SSM Parameter Store일부 시크릿 값을 참조하는 외부 저장소로 추정
도구
- Sealed Secrets일부 서비스의 시크릿을 암호화 저장하는 방식 중 하나
- SOPS일부 서비스의 시크릿을 암호화 저장하는 방식 중 하나
핵심 포인트
- ArgoCD 설치 매니페스트와 애플리케이션 배포 매니페스트를 한 리포에서 함께 관리
- 10개 이상 마이크로서비스의 환경(dev/qa/prod)·체인(klaytn/polygon/ethereum)별 시크릿을 분리 저장
- sealed-secret/SOPS/SSM 등 여러 시크릿 암호화 방식을 혼용하는 구조 확인
- 새 서비스 추가 시 디렉터리 스캐폴딩만으로 확장 가능한 컨벤션 확립
문제와 해결
문제다수 마이크로서비스와 여러 체인·환경 조합의 시크릿을 하나의 리포에서 안전하게 관리해야 함
해결서비스별로 secrets/<service>/<chain>/<env> 디렉터리 컨벤션을 만들고 sealed-secret/SOPS/SSM 참조 등 암호화된 형태로만 저장
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.