k3s 성숙도 점검 7.2·7.4절 중 파드 재시작을 부르는 것이다. 재시작 창(docs/runbooks/k3s-restart-window.md, PR-D)에 적용한다.
Keycloak 고정: Operator 원격 리소스를 태그 26.7.0 대신 그 태그의 커밋 38fd7a0c…로. 같은 태그의 내용이 한 번 바뀌었다(라이브 build-timestamp 07-09, 지금 렌더 07-23). Operator 이미지와 RELATED_IMAGE_KEYCLOAK, Keycloak CR spec.image를 2026-11-12에 실제로 돌던 digest(파드 imageID)로 고정하고 Operator를 IfNotPresent로. render-phase2.sh·apply-keycloak.sh의 검사 문자열도 같이 바꿨다.
## 무엇을, 왜
k3s 성숙도 점검 7.2·7.4절 중 **파드 재시작을 부르는 것**이다. 재시작 창(`docs/runbooks/k3s-restart-window.md`, PR-D)에 적용한다.
1. **Keycloak 고정**: Operator 원격 리소스를 태그 `26.7.0` 대신 그 태그의 커밋 `38fd7a0c…`로. 같은 태그의 내용이 한 번 바뀌었다(라이브 build-timestamp 07-09, 지금 렌더 07-23). Operator 이미지와 `RELATED_IMAGE_KEYCLOAK`, Keycloak CR `spec.image`를 2026-11-12에 실제로 돌던 digest(파드 imageID)로 고정하고 Operator를 `IfNotPresent`로. `render-phase2.sh`·`apply-keycloak.sh`의 검사 문자열도 같이 바꿨다.
2. **PriorityClass 붙이기**: `platform-critical` → Keycloak(CR `spec.scheduling`), Gitea. `platform-low` → Loki(`singleBinary`), Tempo.
## 고른 방법과 버린 대안
- `spec.image`를 정하면 Operator가 「최적화 빌드된 이미지」로 보고 `--optimized`로 띄운다. 이것은 stock 이미지라 `startOptimized: false`를 같이 둔다(지금처럼 시작할 때 빌드).
- `RELATED_IMAGE_KEYCLOAK`는 strategic merge patch(이름 기준)로 바꿨다. 처음 JSON patch를 env 0번에 걸었더니 `KUBERNETES_NAMESPACE`가 바뀌어서 버렸다.
- Grafana·pgAdmin은 chart에 최상위 `priorityClassName`이 없어(고정 버전 `helm show values`로 확인) 이번에 붙이지 않았다. platform-postgres는 W1 파일, tech-log는 tech-log `deploy/`다.
- Keycloak 서버 파드의 pull policy는 CR에 필드가 없어(`unsupported.podTemplate`만 가능) 그대로 두었다. digest라 내용은 바뀌지 않지만 재시작 때 quay.io 응답은 여전히 필요하다.
## 위험과 영향
- 적용하면 Keycloak Operator, Keycloak(로그인 1~2분 중단), Gitea, Loki, Tempo가 한 번씩 재시작된다. 그래서 재시작 창에 한다.
- **PriorityClass를 먼저 만들어야 한다**(PR #4의 `services/priority-classes`, 아직 라이브 미적용). 없는 클래스를 가리키는 파드는 생성이 거절된다. README와 재시작 창 runbook에 순서를 적었다.
- 재시작 창 전까지 이 객체들은 drift로 보이므로 `live-drift-accepted.txt`에 기한(2026-11-30)을 달아 넣었다.
## 검증
desktop, Helm 3.19.4, Kustomize 5.8.1.
```text
render-phase1.sh / render-phase2.sh / render-observability-core.sh (모두 exit 0, 두 커밋 각각에서 render-phase2 통과)
렌더 안: Deployment/gitea platform-critical, StatefulSet/loki·tempo platform-low,
Keycloak image=quay.io/keycloak/keycloak@sha256:0f198be… startOptimized=False priority=platform-critical
kubectl diff(서버 dry-run) vs 라이브: 위 필드, Operator 이미지·IfNotPresent·RELATED_IMAGE_KEYCLOAK digest,
그리고 이미 받아들인 차이(prometheus-operator·KSM 이미지 문자열)만
```
- 적용은 하지 않았다(재시작 창, 소유자).
## 리뷰어가 볼 곳
- `infrastructure/controllers/keycloak-operator/kustomization.yaml`: 커밋 고정과 patch.
- `services/keycloak/base/keycloak.yaml`: `startOptimized: false`.
- `scripts/validate/live-drift-accepted.txt`: 새 받아들인 차이 넷.
## 관련
- `docs/reviews/2026-11-11-k3s-maturity-review.md` A3·A5, 7.2·7.4
- PR #4(PriorityClass 정의), PR #5(k3s 재시작 묶음)
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.
The PriorityClasses exist in the repository but no pod uses them, so
every platform pod still evicts at priority 0.
Attach platform-critical to Keycloak (CR spec.scheduling) and Gitea
(chart priorityClassName), and platform-low to Loki (singleBinary) and
Tempo. The Keycloak CR also gets spec.image at the running 26.7.0
digest with startOptimized: false: with spec.image the operator
otherwise assumes a pre-built optimized image, and this is the stock
one. Grafana and pgAdmin have no top-level priorityClassName in their
charts and are left for later; platform-postgres is W1's file and
tech-log belongs to its deploy/ directory.
Risk: applying restarts Keycloak, Gitea, Loki and Tempo once, so it
belongs in the k3s restart window, after the PriorityClasses exist (a
pod that names a missing class is rejected). The accepted-drift list
holds these objects until 2026-11-30.
Verification (desktop): render-phase1/2 and render-observability-core
pass with the four priorityClassName values; kubectl diff (server
dry-run) against live shows only these fields.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
k3s 성숙도 점검 7.2·7.4절 중 파드 재시작을 부르는 것이다. 재시작 창(
docs/runbooks/k3s-restart-window.md, PR-D)에 적용한다.26.7.0대신 그 태그의 커밋38fd7a0c…로. 같은 태그의 내용이 한 번 바뀌었다(라이브 build-timestamp 07-09, 지금 렌더 07-23). Operator 이미지와RELATED_IMAGE_KEYCLOAK, Keycloak CRspec.image를 2026-11-12에 실제로 돌던 digest(파드 imageID)로 고정하고 Operator를IfNotPresent로.render-phase2.sh·apply-keycloak.sh의 검사 문자열도 같이 바꿨다.platform-critical→ Keycloak(CRspec.scheduling), Gitea.platform-low→ Loki(singleBinary), Tempo.고른 방법과 버린 대안
spec.image를 정하면 Operator가 「최적화 빌드된 이미지」로 보고--optimized로 띄운다. 이것은 stock 이미지라startOptimized: false를 같이 둔다(지금처럼 시작할 때 빌드).RELATED_IMAGE_KEYCLOAK는 strategic merge patch(이름 기준)로 바꿨다. 처음 JSON patch를 env 0번에 걸었더니KUBERNETES_NAMESPACE가 바뀌어서 버렸다.priorityClassName이 없어(고정 버전helm show values로 확인) 이번에 붙이지 않았다. platform-postgres는 W1 파일, tech-log는 tech-logdeploy/다.unsupported.podTemplate만 가능) 그대로 두었다. digest라 내용은 바뀌지 않지만 재시작 때 quay.io 응답은 여전히 필요하다.위험과 영향
services/priority-classes, 아직 라이브 미적용). 없는 클래스를 가리키는 파드는 생성이 거절된다. README와 재시작 창 runbook에 순서를 적었다.live-drift-accepted.txt에 기한(2026-11-30)을 달아 넣었다.검증
desktop, Helm 3.19.4, Kustomize 5.8.1.
리뷰어가 볼 곳
infrastructure/controllers/keycloak-operator/kustomization.yaml: 커밋 고정과 patch.services/keycloak/base/keycloak.yaml:startOptimized: false.scripts/validate/live-drift-accepted.txt: 새 받아들인 차이 넷.관련
docs/reviews/2026-11-11-k3s-maturity-review.mdA3·A5, 7.2·7.4