refactor: 폴더 구조 변경

2026-08-02 00:22:19 +09:00
parent f9c463f87a
commit be2f8e4863
1869 changed files with 4565 additions and 295591 deletions
@@ -0,0 +1,44 @@
+# Project GitOps layout
+
+Project-specific Kubernetes resources are split into reusable catalogs and
+cluster entrypoints.
+
+```text
+gitops/
+├── apps/
+│   ├── auth-server/
+│   ├── identity-postgres/
+│   ├── auth-migration/
+│   └── keycloak-realm-import/
+├── platform/
+│   ├── cert-manager/
+│   ├── forward-auth/
+│   ├── keycloak/
+│   ├── keycloak-operator/
+│   ├── minio/
+│   ├── registry/
+│   ├── secret-delivery/
+│   ├── traefik/
+│   └── vault/
+├── policies/baseline/
+├── tenants/mnt/
+└── clusters/lab/main/
+    ├── stages/
+    └── all/
+```
+
+Rules:
+
+- Catalog `base`는 환경 중립 shape를 소유하고 `overlays/<env>`는 차이만
+  표현합니다.
+- `clusters/lab/main/stages/*`만 현재 deployable entrypoint입니다.
+- `clusters/lab/main/all`은 전체 렌더와 정적 검사 전용이며 apply하지 않습니다.
+- operator readiness, Vault init, Secret 생성과 Job 완료는 stage 사이에서
+  `scripts/bin/bootstrap.sh`가 확인합니다.
+- 새 deployable entrypoint는 `tests/kustomize-entrypoints.txt`에 추가합니다.
+
+```bash
+kubectl kustomize gitops/clusters/lab/main/all >/tmp/project-infra-lab.yaml
+export KUBE_CONTEXT_LAB='<expected-context>'
+bash scripts/bin/bootstrap.sh lab
+```