Add platform infrastructure configuration

2026-08-28 17:35:41 +09:00
parent fa76531e5b
commit 16c337bcc9
302 changed files with 83259 additions and 1 deletions
@@ -0,0 +1,81 @@
+# MinIO AIStor ObjectStore
+
+상태(2026-07-23):
+
+- baseline ObjectStore와 인증 S3 스모크: 실제 적용 완료
+- admin-oidc profile과 비공개 Console Ingress: 선언형 구현·dry-run 완료, live 적용 대기
+
+공식 Chart를 수정하지 않고 Kustomize가 Helm을 렌더한다.
+
+## 빌드 루트
+
+- services/minio-aistor: 현재 live baseline 진입점
+- services/minio-aistor/base/deployment: 공통 Helm baseline과 values
+- services/minio-aistor/profiles/admin-oidc: baseline에 OIDC, Console Ingress와
+  추가 NetworkPolicy를 결합한 진입점
+
+root와 profile이 같은 형제 baseline을 참조하므로 profile이 조상 root를 다시
+포함하는 Kustomize 순환이 없다.
+
+## 고정 원본
+
+| 항목 | 값 |
+|---|---|
+| Chart 저장소 | https://helm.min.io/ |
+| Chart | aistor-objectstore |
+| 버전 | 1.0.16 |
+| archive SHA-256 | 50ffa6a4e014cdc48566b237593baab41d039f103cdc50c1b1ac173b8d8bf71e |
+
+검증기가 만드는 임시 Chart cache는
+base/deployment/.helm/charts/aistor-objectstore-1.0.16 아래에만 존재하고 종료 시
+제거한다.
+
+## baseline 계약
+
+- namespace: object-storage
+- ObjectStore: minio-aistor
+- pool/server/volume: 각각 1
+- 저장소: aistor-local-xfs-retain, 900Gi RWO
+- S3와 Console Service: ClusterIP
+- baseline Ingress, NodePort, LoadBalancer: 없음
+- pvcProtection과 Retain Local PV
+- 기존 root 계정: 비상용으로 유지
+
+Standalone이므로 erasure-code 이중화와 노드 failover는 없다.
+
+## Secret 계약
+
+baseline:
+
+- object-storage/aistor-root-configuration: config.env
+
+admin-oidc profile:
+
+- object-storage/aistor-keycloak-oidc: client-id, client-secret
+
+평문, Base64, checksum을 Git과 문서에 기록하지 않는다.
+
+## 렌더와 적용
+
+baseline 정적 렌더:
+
+    kubectl kustomize --enable-helm services/minio-aistor
+
+admin profile 전체 정적 검증:
+
+    PLATFORM_HELM_BIN=/home/donghyeon/.local/bin/helm \
+      bash scripts/validate/render-admin-services.sh
+
+admin profile 실제 적용은 private DNS, admin 인증서와 Keycloak client/group 준비
+뒤 apply-admin-services.sh가 수행한다. S3 API에는 Ingress를 만들지 않는다.
+
+현재 baseline은 Initialized/green이고 data0-minio-aistor-pool-0-0 PVC가
+aistor-data-local-pv에 Bound다. S3 회귀 검사는 다음과 같다.
+
+    bash scripts/validate/aistor-s3-smoke.sh --execute
+
+## 공식 문서
+
+- https://docs.min.io/aistor/reference/kubernetes/object-store-helm-chart/
+- https://docs.min.io/aistor/reference/kubernetes/pvc-protection/
+- https://docs.min.io/aistor/administration/iam/identity/keycloak-identity/