# 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 기본값으로 재사용하지 않습니다.