인프라
Compose·K8s 하이브리드 배포 구성 문서
Docker Compose와 Kubernetes(Kustomize)를 병행 운용하는 플랫폼 배포 구성을 정리한 문서 레포지토리
news-platform-deploy-config-docs최근 업데이트 2026년 7월 26일
개요
개발/스테이징 환경은 Docker Compose 오버레이로, 프로덕션 환경은 Kubernetes Kustomize와 ArgoCD로 배포하는 하이브리드 배포 전략을 정리한 문서입니다. docker 디렉터리에는 서비스별 compose 템플릿(base + overlay)을, kubernetes 디렉터리에는 Kustomize base와 overlay 구성을 두어 환경별 배포 설정을 분리 관리합니다. scripts 디렉터리에는 오버레이 렌더링과 프로모션을 돕는 헬퍼 스크립트를 포함합니다. 개발/스테이징은 compose 오버레이를 통해 대상 호스트에 직접 배포하고, 프로덕션은 Kustomize overlay를 커밋하면 ArgoCD가 동기화하는 GitOps 흐름을 따릅니다.
담당 역할
배포 구성 문서 작성자로서 Compose와 Kubernetes 간 환경별 배포 전략과 디렉터리 구조, 배포 흐름을 정리했습니다.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
배포
환경별 배포 흐름
개발/스테이징과 프로덕션 환경이 각각 어떤 방식으로 배포되는지를 보여주는 흐름도입니다.
다이어그램을 그리는 중…
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
DevOps
- Docker Compose개발/스테이징 환경의 서비스별 배포 템플릿(base + overlay) 구성
- Kustomize환경별 K8s 매니페스트를 base/overlay로 관리
- ArgoCD프로덕션 배포를 위한 GitOps 기반 자동 동기화
인프라
- Kubernetes프로덕션 환경의 컨테이너 오케스트레이션 기반
핵심 포인트
- 개발/스테이징은 Compose, 프로덕션은 K8s로 나눈 하이브리드 배포 전략을 문서화
- base + overlay 구조로 환경별 설정 중복을 줄이는 방식 정리
- Kustomize overlay 커밋 → ArgoCD sync 흐름으로 GitOps 배포 프로세스 명시
- 오버레이 렌더링·프로모션을 돕는 스크립트 영역을 별도로 분리
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.