docs: prove sessions are shared by PostgreSQL, not Infinispan replication

Experiment 0 with three probes: cross-node refresh/logout, cache counter deltas around a single login, and cache entry ownership. Each node caches only what it handled; cache totals sum exactly to the database count. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 09:58:10 +09:00
parent 006da7d490
commit e5ebaeb623
20 changed files with 1114 additions and 0 deletions
@@ -0,0 +1,52 @@
+===================================================================
+ 실험 0 — 한 노드에서 만든 세션이 다른 노드에서 쓰이는가
+===================================================================
+
+### 사전 확인: 클러스터가 2 멤버로 형성되었는가
+2026-09-04 00:52:09,294 INFO  [org.infinispan.CLUSTER] (executor-thread-1) ISPN000094: Received new cluster view for channel ISPN: [keycloak-1-48749(v=16.0.12)|5] (2) [keycloak-1-48749(v=16.0.12), keycloak-0-30843(v=16.0.12)]
+       name       |       ip        | coord 
+------------------+-----------------+-------
+ keycloak-1-48749 | 10.42.0.35:7800 | t
+ keycloak-0-30843 | 10.42.1.43:7800 | f
+(2 rows)
+
+
+수집 시각: 2026-09-04 09:54:29 KST
+
+=== 대상 ===
+  keycloak-0  10.42.1.43     kc-lab-2
+  keycloak-1  10.42.0.35     kc-lab-1
+
+=== [0] 실험 전 DB 세션 ===
+
+=== [1] keycloak-0 에서 로그인 ===
+  sid          jiv3rVZi1VeaO07oVJkL_MYW
+  sub          None
+  iss          https://auth.hyeonworks.com/realms/master
+  access 수명  60초
+  refresh 수명 1800초   typ=Refresh
+  refresh jti  7669cc49-4778-851f-3c49-65f76964ae8e
+
+=== [3] 같은 sid 가 두 노드 모두에서 보이는가 ===
+  keycloak-0 (발급 노드)       세션 2개 중 대상 sid → 보임 ✔
+      ipAddress=10.42.1.44  start=1788483164000  lastAccess=1788483164000
+  keycloak-1 (반대편)         세션 2개 중 대상 sid → 보임 ✔
+      ipAddress=10.42.1.44  start=1788483164000  lastAccess=1788483164000
+
+=== [5] keycloak-0 이 발급한 refresh token 을 keycloak-1 에 사용 ===
+  HTTP 200   ← 기대대로
+  새 토큰의 sid → 동일 ✔
+
+=== [6] keycloak-1 을 통해 로그아웃 ===
+  http_code=204
+
+=== [7] 로그아웃 후 keycloak-0 에서 갱신 시도 (무효화 전파) ===
+  HTTP 400   ← 기대대로
+  error             invalid_grant
+  error_description Session not active
+
+=== [8] PostgreSQL 에서 그 sid 를 직접 확인 ===
+  대상 sid: jiv3rVZi1VeaO07oVJkL_MYW
+  행 없음 — 로그아웃으로 삭제되었다
+
+  전체 세션 수: 1
@@ -0,0 +1,35 @@
+===================================================================
+ 실험 0b — Infinispan 이 복제한 것인가, DB 를 같이 본 것인가
+===================================================================
+
+수집 시각: 2026-09-04 09:54:41 KST
+
+=== 로그인은 keycloak-0 에만 보냈다 ===
+  로그인 응답: http_code=200
+
+=== keycloak-0 (로그인을 받은 노드) ===
+  계수기                                        캐시                     전        후      증가
+  rpc.replication_count                      clientSessions         1        1      +0
+  rpc.replication_count                      sessions               1        1      +0
+  approximate_entries_unique                 clientSessions         1        2      +1  ←
+  approximate_entries_unique                 sessions               1        2      +1  ←
+  hits                                       clientSessions         2        2      +0
+  hits                                       sessions               2        2      +0
+  misses                                     clientSessions         2        3      +1  ←
+  misses                                     sessions               3        4      +1  ←
+  stores                                     clientSessions         2        3      +1  ←
+  stores                                     sessions               2        3      +1  ←
+
+=== keycloak-1 (아무 요청도 받지 않은 노드) ===
+  계수기                                        캐시                     전        후      증가
+  rpc.replication_count                      clientSessions         7        7      +0
+  rpc.replication_count                      sessions               7        7      +0
+  approximate_entries_unique                 clientSessions         0        0      +0
+  approximate_entries_unique                 sessions               0        0      +0
+  hits                                       clientSessions         4        4      +0
+  hits                                       sessions               4        4      +0
+  misses                                     clientSessions         0        0      +0
+  misses                                     sessions               0        0      +0
+  stores                                     clientSessions         1        1      +0
+  stores                                     sessions               1        1      +0
+
@@ -0,0 +1,15 @@
+===================================================================
+ 실험 0c — 세션 엔트리는 어느 노드에 있는가 (로컬 캐시인가 분산인가)
+===================================================================
+
+수집 시각: 2026-09-04 09:54:54 KST
+  keycloak-0 = 10.42.1.43  (kc-lab-2)
+  keycloak-1 = 10.42.0.35  (kc-lab-1)
+
+단계                             k0 entries   k1 entries
+시작                                    2.0          0.0
+keycloak-1 에 로그인 5회             2.0          5.0
+keycloak-0 에 로그인 5회             7.0          5.0
+
+=== 대조: PostgreSQL 에는 몇 건인가 ===
+  online 세션 12
@@ -0,0 +1,17 @@
+# 실험 0 — 세션 복제 증거
+
+수집: 2026-09-04 09:54 KST · Keycloak 26 / Infinispan 16.0.12 / PostgreSQL 16
+해설: [`docs/experiment-00-session-replication.md`](../../experiment-00-session-replication.md)
+
+| 파일 | 무엇을 보여주는가 |
+|---|---|
+| `01-cross-node-session.txt` | 클러스터 2멤버 확인 → keycloak-0 로그인 → 같은 sid 가 양쪽에서 보임 → **keycloak-1 이 refresh 성공(200)** → keycloak-1 로그아웃 → **keycloak-0 갱신 실패(400)** → DB 행 삭제 확인 |
+| `02-cache-delta.txt` | 로그인 하나를 사이에 둔 양쪽 노드의 캐시 계수기. **keycloak-1 은 전부 +0** |
+| `03-cache-ownership.txt` | 로그인을 반대편에 몰아준 결과. **요청을 받은 노드에서만 엔트리가 는다.** 캐시 합 7+5 = DB 12 |
+| `session-cache-entries-per-pod.png` | 위 사실의 시계열. 파란 선(keycloak-1)이 0에 붙어 있는 동안 초록 선(keycloak-0)만 14까지 오른다 |
+| `keycloak-admin-sessions.png` | 관리 콘솔의 Sessions 화면. 브라우저는 nginx→Traefik 을 거쳐 두 파드 중 하나에 닿지만 **어느 파드가 만든 세션이든 전부 보인다** |
+
+## 핵심 한 줄
+
+클러스터는 형성되지만 **세션 엔트리는 노드를 건너가지 않는다.**
+두 노드가 같은 답을 하는 이유는 Infinispan 복제가 아니라 **같은 PostgreSQL** 이다.