docs: A-8 — a rolling restart keeps every session and drops only the cache

Nine samples through the restart all returned 200, the refresh token issued beforehand still works, and the session count is unchanged at 151 while both caches reset to zero. The updated last_session_refresh proves the write path recovered too, not just the response code.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/evidence/a8-rolling-restart/01-restart-availability.txt

@@ -0,0 +1,17 @@
+=== [1] 재시작 전 로그인 — 토큰을 파드 안에 보관 ===
+  sid = XLcgQWRiJrTkuNZcJsNeT_2j
+  DB 세션 수: 151
+
+=== [2] 롤링 재시작 중 가용성 — 5초 간격으로 외부 진입점 확인 ===
+statefulset.apps/keycloak restarted
+200 Waiting for partitioned roll out to finish: 0 out of 2 new pods have been updated...
+Waiting for 1 pods to be ready...
+Waiting for 1 pods to be ready...
+Waiting for 1 pods to be ready...
+200 200 200 200 Waiting for partitioned roll out to finish: 1 out of 2 new pods have been updated...
+Waiting for 1 pods to be ready...
+Waiting for 1 pods to be ready...
+Waiting for 1 pods to be ready...
+200 200 200 200 partitioned roll out complete: 2 new pods have been updated...
+
+  (위 숫자열이 재시작 중 외부 응답 코드의 시계열)

docs/evidence/a8-rolling-restart/02-session-survival.txt

@@ -0,0 +1,19 @@
+=== [3] 재시작 전 발급한 refresh token 이 아직 통하는가 ===
+  대상 sid: XLcgQWRiJrTkuNZcJsNeT_2j
+  keycloak-0 에서 refresh  HTTP 200
+
+=== [4] DB 에 그 세션이 남아 있는가 ===
+     user_session_id      | created_on | last_session_refresh 
+--------------------------+------------+----------------------
+ XLcgQWRiJrTkuNZcJsNeT_2j | 1788495513 |           1788495577
+(1 row)
+
+  전체 온라인 세션: 151 (재시작 전 151)
+
+=== [5] 캐시는 어떻게 되었는가 ===
+  keycloak-0  sessions 캐시 0.0 건 / cluster_size 2.0
+  keycloak-1  sessions 캐시 1.0 건 / cluster_size 2.0
+
+=== [6] 파드 나이 — 정말 재시작되었나 ===
+keycloak-0                  1/1   Running   0     44s
+keycloak-1                  1/1   Running   0     66s

docs/evidence/a8-rolling-restart/README.md

@@ -0,0 +1,16 @@
+# A-8 — 롤링 재시작 증거
+
+2026-09-04 13:38–13:41 KST
+해설: [`docs/experiment-a8-rolling-restart.md`](../../experiment-a8-rolling-restart.md)
+
+| 파일 | 무엇을 보여주는가 |
+|---|---|
+| `01-restart-availability.txt` | 재시작 전 로그인(sid 기록), 롤링 재시작 중 외부 진입점 **9회 모두 `200`** |
+| `02-session-survival.txt` | 재시작 전 토큰으로 refresh **`200`**, DB 행 생존(`last_session_refresh` 갱신 확인), **세션 수 151 → 151**, 캐시 0으로 초기화, 파드 나이 44초/66초 |
+| `a8-cache-reset-cluster-reformed.png` | Grafana — 세션 캐시가 0 으로 떨어지고 `cluster_size` 가 다시 2 가 되는 구간 |
+
+## 핵심 세 줄
+
+1. **무중단이었다.** 한 번에 하나씩 내리고 readiness 가 전환을 맞춰준다 — replica ≥ 2 가 전제.
+2. **세션은 살아남고 캐시만 사라진다.** DB 151건 그대로, 재시작 전 토큰이 그대로 통한다.
+3. **이것이 `persistent-user-sessions` 를 켜는 진짜 이유다.** A-7(volatile)에서 정반대가 나와야 한다.