init: k8s 폴더 구조init

examples/README.md

@@ -0,0 +1,28 @@
+# Examples
+
+예제는 구조와 조립 방식을 설명하기 위한 설계 참고 자료이며 실제 reconcile
+대상이 아닙니다.
+
+- [`minimal`](minimal/README.md): `kubectl kustomize`로 렌더 가능한 단일
+  환경·단일 클러스터의 canonical 구조
+- [`scaled`](scaled/README.md): 여러 계정·환경·리전·클러스터로 확장할 때의
+  경로와 state 분리 기준
+
+## 활용 순서
+
+1. `minimal`에서 `infrastructure/live`, catalog `base`,
+   `gitops/clusters`의 관계를 확인합니다.
+2. 규모가 커질 가능성이 있으면 `scaled`에서 account/region/environment
+   segment와 state 분리 기준을 선택합니다.
+3. 실제 구현은 예제가 아니라 다음 `_template`을 복사해 시작합니다.
+
+| 영역 | 복사 원본 |
+|---|---|
+| Infrastructure | `../infrastructure/components/_template`, `../infrastructure/stacks/_template`, `../infrastructure/live/_template` |
+| GitOps | `../gitops/clusters/_template`, `../gitops/platform/_template`, `../gitops/apps/_template`, `../gitops/policies/_template`, `../gitops/tenants/_template` |
+
+4. 실제 `live`와 cluster root가 예제와 같은 소유권·조립 경계를 유지하는지
+   비교하고 `make check`로 검증합니다.
+
+예제 디렉터리를 GitOps controller root로 연결하거나 예제의 이름, namespace,
+값을 production 기본값으로 재사용하지 않습니다.