Files
DongHyeonka 9751db0e97 feat(keycloak): pin the operator source and both images by digest
The Keycloak Operator remote resource is pinned to the tag 26.7.0, and
that tag's content changed once (live build-timestamp 2026-07-09,
later renders 2026-07-23). Both images use the 26.7.0 tag with
imagePullPolicy Always, so every restart depends on quay.io and could
pull different bits.

Pin the remote resource to the tag's commit, the operator image and
RELATED_IMAGE_KEYCLOAK to the digests that were running on 2026-11-12
(pod imageID) and set the operator to IfNotPresent. The env value is
set with a strategic merge patch keyed by name; a JSON patch by list
index hit KUBERNETES_NAMESPACE instead. render-phase2.sh and
apply-keycloak.sh check the commit and the digest.

Risk: applying restarts the Keycloak operator once (restart window).
Keycloak itself keeps running.

Verification (desktop): render-phase2.sh passes; the rendered
Deployment has the pinned image, IfNotPresent and the digest in
RELATED_IMAGE_KEYCLOAK with the other env entries unchanged.
2026-11-12 01:25:24 +09:00
..

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
  • 원격 ref: 태그가 아니라 그 태그의 커밋 38fd7a0c84e15d4b66b37d1c2ea728ca2f5416a4(2026-11-12). 같은 태그의 내용이 한 번 바뀌었다(build-timestamp 07-09 → 07-23, 성숙도 점검 A5).
  • 이미지: Operator·Keycloak 모두 2026-11-12에 돌던 digest로 고정, Operator imagePullPolicy: IfNotPresent. Keycloak CR의 spec.image를 정하면 Operator가 최적화 빌드된 이미지로 보므로 startOptimized: false를 같이 둔다. 올릴 때는 태그·커밋·두 digest와 scripts/validate/render-phase2.sh·scripts/bootstrap/apply-keycloak.sh의 검사 문자열을 함께 바꾼다.
  • 설치 모드: keycloak namespace 범위

업스트림 namespace 범위 Deployment는 각 컨트롤러의 감시 namespace를 JOSDK_WATCH_CURRENT로 설정한다. 이 단일 인스턴스 홈 클러스터에서는 프리뷰 상태인 cluster-wide Overlay로 전환하지 않는다.

이 디렉터리에서 다음과 같이 렌더링한다.

kubectl kustomize infrastructure/controllers/keycloak-operator

remote 참조가 Kustomize 캐시에 없으면 네트워크 접근이 필요하다. Argo CD가 고정된 GitHub 원본을 가져올 수 있어야 한다.

공식 참고 문서