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,35 @@
+# Keycloak Operator
+
+상태: `26.7.0` 실제 적용, Operator와 Keycloak Server 각각 `1/1` Ready  
+namespace는 `baseline` enforce·`restricted` warn이다. 공식 Operator 적용 시
+restricted 필드 경고가 있었지만 baseline 정책에서 rollout은 성공했으므로 이를
+restricted 준수 완료로 표현하지 않는다.
+
+이 디렉터리는 Keycloak Operator의 유일한 Kustomize 빌드 루트다. 공식 Keycloak
+Kubernetes 리소스를 직접 참조하며 업스트림 매니페스트를 복제하거나 수정하지
+않는다.
+
+## 고정된 원본
+
+- 저장소: <https://github.com/keycloak/keycloak-k8s-resources>
+- 리소스 경로: `kubernetes`
+- Keycloak 및 Operator 버전: `26.7.0`
+- 설치 모드: `keycloak` namespace 범위
+
+업스트림 namespace 범위 Deployment는 각 컨트롤러의 감시 namespace를
+`JOSDK_WATCH_CURRENT`로 설정한다. 이 단일 인스턴스 홈 클러스터에서는 프리뷰
+상태인 `cluster-wide` Overlay로 전환하지 않는다.
+
+이 디렉터리에서 다음과 같이 렌더링한다.
+
+```bash
+kubectl kustomize infrastructure/controllers/keycloak-operator
+```
+
+remote 참조가 Kustomize 캐시에 없으면 네트워크 접근이 필요하다. Argo CD가 고정된
+GitHub 원본을 가져올 수 있어야 한다.
+
+## 공식 참고 문서
+
+- <https://www.keycloak.org/operator/installation>
+- <https://github.com/keycloak/keycloak-k8s-resources/tree/26.7.0/kubernetes>
@@ -0,0 +1,5 @@
+# 기본 확장 지점
+
+공식 namespace 범위 Operator는 컨트롤러 디렉터리 루트의 Kustomization에서
+참조한다. 환경에 종속되지 않는 보조 리소스만 이곳에 추가하며, 생성된 CRD,
+RBAC 또는 Operator Deployment를 저장소에 복제하지 않는다.
@@ -0,0 +1,12 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+namespace: keycloak
+
+resources:
+  - github.com/keycloak/keycloak-k8s-resources/kubernetes?ref=26.7.0
+
+labels:
+  - pairs:
+      app.kubernetes.io/part-of: platform
+    includeSelectors: false
@@ -0,0 +1,5 @@
+# 홈 환경 Overlay 확장 지점
+
+Keycloak Operator 26.7.0에는 홈 환경 전용 Patch가 필요하지 않다. 고정한 업스트림
+리소스를 로컬 Kustomize와 향후 Argo CD에서 일관되게 렌더링하도록 컨트롤러
+디렉터리를 유일한 빌드 루트로 유지한다.