뉴스 플랫폼 K8s 클러스터 부트스트랩 문서
뉴스/미디어 플랫폼용 쿠버네티스 클러스터의 컨트롤 플레인 부트스트랩 구성을 정리한 관찰 문서
개요
뉴스/미디어 플랫폼이 올라가는 Kubernetes 클러스터를 신규 프로비저닝할 때 필요한 초기 컴포넌트 설치 흐름을 정리한 문서 레포입니다. argo-cd, cert-manager, ingress-nginx, post-install-resources 4개의 Helm 차트를 install-upgrade 스크립트로 순차 설치하고, post-install-resources 차트로 ArgoCD Application, ClusterIssuer, Ingress 등 기본 리소스를 배포하는 부트스트랩 절차를 다룹니다. 컨트롤 플레인 구성과 애플리케이션 배포를 명확히 분리해, 실제 애플리케이션 매니페스트는 별도 GitOps 리포로 위임하는 구조입니다. Helm 차트는 upstream 버전을 특정 시점에 vendored 하여 재현 가능성을 확보한 점이 특징입니다.
담당 역할
뉴스 플랫폼 인프라의 클러스터 부트스트랩 구조를 설계하고, 설치 스크립트와 Helm 차트 구성을 정리해 문서화했습니다.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
클러스터 부트스트랩 흐름
신규 NKS 클러스터 프로비저닝부터 컨트롤 플레인 컴포넌트 설치, 이후 애플리케이션 배포 위임까지의 흐름을 보여줍니다.
리포 구조
nks 디렉터리 하위의 Helm 차트와 스크립트 구성을 보여줍니다.
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
인프라
- Kubernetes뉴스 플랫폼이 운영되는 클러스터 환경
- ingress-nginx클러스터 진입 트래픽을 처리하는 인그레스 컨트롤러
DevOps
- Helmargo-cd, cert-manager, ingress-nginx 등 클러스터 컴포넌트 차트 관리
- Argo CDGitOps 기반 애플리케이션 배포를 위한 컨트롤러 설치
- cert-manager클러스터 TLS 인증서 자동 발급 및 갱신
도구
- Shell Scriptinstall/upgrade/uninstall 등 클러스터 부트스트랩 명령 자동화
- Makefile부트스트랩 스크립트 실행을 위한 진입점 제공
핵심 포인트
- 컨트롤 플레인 컴포넌트와 애플리케이션 배포를 분리해 관심사를 명확히 구분함
- Helm 차트를 upstream 그대로 vendored 하여 특정 시점을 pin, 재현 가능성 확보
- install-upgrade 스크립트로 argo-cd, cert-manager, ingress-nginx 순차 설치 자동화
- post-install-resources 차트로 ClusterIssuer, Ingress 등 초기 리소스를 일괄 배포
문제와 해결
문제클러스터 컴포넌트와 애플리케이션 매니페스트가 뒤섞이면 부트스트랩 절차와 배포 절차의 책임 경계가 모호해짐
해결이 리포는 클러스터 컴포넌트 부트스트랩만 담당하고, 애플리케이션 배포는 별도 GitOps 리포(news-platform-deploy-config)로 위임
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.