The Rendered Manifests Pattern

- Akuity Blog

Deploy with Argo CD, promote seamlessly with Kargo, and gain real-time visibility into your infrastructure using KubeVision

https://akuity.io/blog/the-rendered-manifests-pattern

1. GitOps와 설정 관리의 현재 문제점

1.1. 기존 GitOps 접근 방식의 한계

•

GitOps는 가시성과 협업 문제를 해결하기 위한 원칙을 제공하지만, 실제 구현에서 많은 해석의 여지가 있음

•

Git 저장소 구조, 설정 관리 도구 선택, 브랜치 전략 등에 대한 명확한 가이드라인 부재

•

Helm과 Kustomize 같은 도구들이 제공하는 추상화가 새로운 문제를 야기

1.2. 설정 관리 도구의 문제점

예시: Helm 차트 버전 변경
chartVersion: 1.2.3 -> 1.2.4

이러한 작은 변경이 실제로는:
- 수백 줄의 매니페스트 변경
- 여러 환경에 걸친 영향
- 예측하기 어려운 부작용을 초래할 수 있음
Plain Text
복사

2. Rendered Manifests 패턴의 상세 구현

2.1. 핵심 아키텍처

메인 브랜치 워크플로우

•

소스 코드 변경

•

CI 파이프라인 트리거

•

매니페스트 렌더링

•

환경별 브랜치에 결과물 저장

환경별 브랜치 관리

main (소스)
├── dev-manifests (개발 환경 매니페스트)
├── staging-manifests (스테이징 환경 매니페스트)
└── prod-manifests (프로덕션 환경 매니페스트)
Plain Text
복사

2.2. 상세 프로세스 흐름

개발 단계

•

개발자가 메인 브랜치에 변경사항 커밋

•

CI 시스템이 자동으로 매니페스트 렌더링

•

비프로덕션 환경 브랜치에 자동 업데이트

프로덕션 배포 단계

•

임시 브랜치 생성

•

렌더링된 매니페스트로 PR 생성

•

코드 리뷰 및 승인 프로세스

•

prod-manifests 브랜치에 머지

2.3. 보안 및 접근 제어

브랜치 보호 정책

개발 환경: 자동 배포 허용
스테이징 환경: 기본적인 리뷰 필요
프로덕션 환경:
- 필수 리뷰어 승인
- CI 체크 통과
- 직접 푸시 금지
Plain Text
복사

시크릿 관리 전략

•

External Secrets Operator 사용

•

SecretStore에서 시크릿 참조

•

ExternalSecret 리소스로 관리

3. 성능 최적화

3.1. Argo CD 성능 향상

리소스 사용량 감소

•

기존: 레포 서버에서 지속적인 매니페스트 생성

•

개선: CI에서 1회 생성으로 변경

캐시 효율성

•

매니페스트 재생성 필요성 감소

•

캐시 무효화 빈도 감소

3.2. CI 최적화

최적화 전략:
1. 병렬 매니페스트 렌더링
2. 증분 업데이트 지원
3. 캐시 활용
Plain Text
복사

4. 모니터링 및 문제 해결

4.1. 변경 추적

매니페스트 변경 이력

•

커밋 히스토리로 완벽한 감사 추적

•

변경사항의 명확한 가시성

차이점 분석

변경 전/후 비교:
- 리소스 구성 변경
- 설정 값 변경
- 버전 업데이트
Plain Text
복사

4.2. 롤백 전략

즉각적 롤백

•

이전 커밋으로 간단히 되돌리기

•

매니페스트 재생성 불필요

부분 롤백

•

특정 컴포넌트만 선택적 롤백

•

영향 범위 최소화

5. 모범 사례 및 권장 사항

5.1. 저장소 구조

/
├── src/
│   ├── helm/
│   └── kustomize/
├── .github/workflows/
│   ├── render-dev.yaml
│   ├── render-staging.yaml
│   └── render-prod.yaml
└── docs/
    └── deployment-guides/
Plain Text
복사

5.2. 배포 전략

단계적 배포

•

개발 환경 자동 배포

•

스테이징 환경 검증

•

프로덕션 환경 승인 기반 배포

긴급 패치 절차

•

핫픽스 브랜치 생성

•

신속한 리뷰 프로세스

•

자동화된 테스트 실행

이러한 상세한 구현과 관리 방법을 통해 Rendered Manifests 패턴은 큰 규모의 Kubernetes 환경에서도 안정적이고 확장 가능한 GitOps 실행을 가능하게 합니다.