refactor: 구조 변경

gitops/clusters/dev-k3s/README.md

@@ -0,0 +1,35 @@
+# dev-k3s cluster profile
+
+`dev-k3s`는 이 reference lab이 현재 지원하는 유일한 cluster profile입니다.
+ApplicationSet의 `server`는 in-cluster API
+`https://kubernetes.default.svc`를 사용합니다.
+
+`kustomization.yaml`은 bootstrap root Application이 읽는 유일한 cluster
+entrypoint이며 permission-scoped Argo CD control plane을 조립합니다.
+ApplicationSet inventory는 아래 cluster-specific overlay를 child
+Application source로 선택합니다.
+
+- `overlays/platform/vault`: dev Vault namespace, NetworkPolicy와 single-node profile
+- `overlays/systems/auth-system`: `auth-system-dev` namespace, internal/public host,
+  Vault injection path와 system NetworkPolicy
+- `overlays/workloads/*`: dev namespace, image reference, ingress, pull
+  SealedSecret과 workload NetworkPolicy
+
+현재 Vault NetworkPolicy의 Kubernetes API CIDR와 node address는
+`dev-k3s`에 종속됩니다. 다른 클러스터에 그대로 복사하지 말고 해당
+클러스터의 service/node network를 확인해야 합니다.
+
+두 번째 클러스터를 추가할 때는 다음 순서를 사용합니다.
+
+1. 실제 차이가 있는 overlay만 `gitops/clusters/<cluster>/overlays`에
+   추가합니다.
+2. Argo CD cluster credential을 Git 밖에서 등록합니다.
+3. 각 AppProject destination에 정확한 API server/namespace를 추가합니다.
+4. 권한별 ApplicationSet inventory에 `autoSync: "false"` element를
+   추가합니다.
+5. Render, live diff와 외부 prerequisite를 검증한 단계별 PR로 gate를
+   엽니다.
+
+Production은 이 profile의 이름 변경이나 복사로 만들지 않습니다. TLS,
+availability, secret authority, storage/backup, approval과 recovery
+contract를 먼저 별도 설계해야 합니다.