init: k8s 폴더 구조init

2026-07-26 17:11:25 +09:00
commit 0912b5030f
61 changed files with 2124 additions and 0 deletions
@@ -0,0 +1,23 @@
+# Platform Catalog
+
+클러스터 전체에서 사용하는 addon과 controller의 재사용 구성을 둡니다.
+
+예:
+
+```text
+platform/
+├── ingress/
+├── certificates/
+├── external-dns/
+├── external-secrets/
+├── storage/
+├── autoscaling/
+└── observability/
+```
+
+실제로 사용하는 항목만 만듭니다. 각 component는 자신의 CRD, controller,
+configuration과 values/patch를 응집해서 관리합니다. component 간 숨은 의존을
+만들지 말고 cluster root 또는 선택한 GitOps controller의 ordering 기능으로
+순서를 표현합니다.
+
+새 component는 `_template`을 복사해 시작합니다.
@@ -0,0 +1,21 @@
+# __REPLACE_ME_PLATFORM_COMPONENT_NAME__
+
+## 책임
+
+이 component가 소유하는 CRD, controller와 configuration을 적습니다.
+
+## 의존성
+
+선행 component, namespace, identity와 최소 Kubernetes version을 적습니다.
+
+## 구성
+
+- `base`: 모든 대상에서 공유하는 기본값
+- `overlays`: 환경/규모별 차이가 실제로 있을 때만 추가
+
+Helm을 사용하면 chart source/version, values와 release 리소스를 이 component
+안에 함께 둡니다. 원격 version은 고정합니다.
+
+## 운영
+
+upgrade 순서, health check, rollback과 uninstall 영향을 runbook으로 연결합니다.
@@ -0,0 +1,7 @@
+# Base
+
+환경과 클러스터를 모르는 재사용 가능한 기본 manifest만 둡니다.
+
+- 실제 domain, account ID, credential을 하드코딩하지 않습니다.
+- resource request/limit와 security context의 안전한 기본값을 둡니다.
+- 환경 차이는 `overlays`에서 patch합니다.
@@ -0,0 +1,4 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources: []
@@ -0,0 +1,7 @@
+# Overlays
+
+공통 base와 다른 값이 있을 때만 `<environment-or-profile>/` overlay를 만듭니다.
+overlay는 base를 참조하고 patch만 포함해야 합니다.
+
+`dev`, `prod` 전체 manifest 복사보다 replica, resource, retention처럼 실제로
+달라지는 항목만 표현합니다.