AWS EKS 기반 AI 음성 분석 플랫폼의 인프라 구성을 관리하는 저장소입니다.
UtterAI_Infra/
├── terraform/ # IaC — VPC, EKS, RDS, Redis, S3, SQS, IRSA 등
│ ├── modules/ # 재사용 가능한 공통 모듈
│ └── environments/ # 환경별 변수 조합 (dev / prod)
│
├── k8s/ # Kustomize 구조 (base + overlays) — Argo CD 배포 대상
├── k8s-legacy/ # Legacy raw Kubernetes 매니페스트 (보관용)
│
├── docs/ # 인프라 설계 및 운영 문서
│ ├── dev/ # Dev 환경 가이드, 보안, 부하 테스트 시나리오
│ └── prod/ # Prod 환경 가이드
│
├── tests/ # 부하 테스트 스크립트 (CA+HPA / Karpenter+KEDA)
├── scripts/ # 배포 자동화 및 마이그레이션 스크립트
└── deploy/ # 배포 관련 설정
| 문서 | 용도 |
|---|---|
docs/README.md |
인프라 환경 개요 (Dev vs Prod 비교, AWS 계정 구조) |
docs/dev/README.md |
Dev 환경 배포 가이드 (Terraform 적용 순서, K8s 배포) |
docs/dev/security-overview.md |
Dev 환경 전체 보안 구현 현황 |
docs/dev/security-hardening.md |
보안 수정 이력 및 잔여 항목 |
docs/dev/load-test-scenarios.md |
CA+HPA / Karpenter+KEDA 부하 테스트 시나리오 |
EKS 클러스터 내부 관측성은 terraform/modules/eks-addons/의 kube-prometheus-stack과 k8s/platform/observability/의 OpenTelemetry Collector 매니페스트를 기준으로 관리한다.
| 브랜치 | 용도 |
|---|---|
main |
Infra repo의 단일 기준 브랜치. Argo CD가 dev/prod Kustomize overlay를 path 기준으로 트래킹. |
feature/* |
새 인프라 리소스 추가 |
fix/* |
버그 수정 |
docs/* |
문서 작업 |
ci/* |
GitHub Actions 워크플로우 변경 |
security/* |
보안 관련 변경 |
상세 규칙은 CONTRIBUTING.md를 따른다.