donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

refactor: 문서 개선 중

Browse Source
This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/keycloak-session-store/final/assets/session-sharing-path/session-sharing-path.drawio
+11 -24
View File
@@ -1,40 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
<diagram id="session-sharing-path" name="세션 공유가 실제로 지나는 경로">
<mxGraphModel dx="680" dy="422" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
<mxGraphModel dx="680" dy="353" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_keycloak-0" value="keycloak-0&lt;br/&gt;자기 처리분만 캐시" tooltip="로그인을 처리하고 자기 sessions 캐시에만 엔트리를 남긴다. | Evidence: L49-L51" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="70.0" y="111.5" width="150.0" height="71.0" as="geometry"/>
<mxCell id="n_replicas" value="Keycloak replica 2개&lt;br/&gt;keycloak-0 · keycloak-1&lt;br/&gt;sessions cache는 각자" tooltip="keycloak-0과 keycloak-1은 각자 sessions cache를 갖고 같은 PostgreSQL을 사용한다. | Evidence: L75-L81" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="70.0" y="140.0" width="195.0" height="88.0" as="geometry"/>
</mxCell>
<mxCell id="n_keycloak-1" value="keycloak-1&lt;br/&gt;refresh 시 DB 조회" tooltip="다른 노드가 만든 세션을 캐시로 받지 않고 데이터베이스에서 읽는다. | Evidence: L48-L51" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="70.0" y="254.5" width="150.0" height="71.0" as="geometry"/>
<mxCell id="n_discovery" value="JGROUPS_PING&lt;br/&gt;노드 둘 등록&lt;br/&gt;discovery만 담당" tooltip="노드 discovery와 membership을 위한 테이블이다. 세션 엔트리 복제 경로가 아니다. | Evidence: L75-L75" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;" vertex="1" parent="1">
<mxGeometry x="437.0" y="60.0" width="150.0" height="88.0" as="geometry"/>
</mxCell>
<mxCell id="n_jgroups-ping" value="JGROUPS_PING&lt;br/&gt;노드 둘 등록&lt;br/&gt;세션 복제 아님" tooltip="노드가 서로를 발견하는 자리. 여기 등록되어 있다는 것과 세션이 복제된다는 것은 다른 사건이다. | Evidence: L44-L46" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#9ca3af;fillColor=#f9fafb;" vertex="1" parent="1">
<mxGeometry x="392.0" y="60.0" width="150.0" height="114.0" as="geometry"/>
<mxCell id="n_session-store" value="OFFLINE_USER_SESSION&lt;br/&gt;keycloak-0 INSERT&lt;br/&gt;keycloak-1 SELECT" tooltip="다른 노드가 만든 세션을 직접 읽는 실제 공유 경로다. | Evidence: L78-L81" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="425.0" y="220.0" width="174.0" height="88.0" as="geometry"/>
</mxCell>
<mxCell id="n_postgres" value="PostgreSQL&lt;br/&gt;OFFLINE_USER_SESSION&lt;br/&gt;offline_flag=&#x27;0&#x27;&lt;br/&gt;두 노드 공용" tooltip="OFFLINE_USER_SESSION 에 세션 행을 보관한다. 두 노드가 같은 행을 본다. | Evidence: L48-L52" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="380.0" y="246.0" width="174.0" height="131.0" as="geometry"/>
</mxCell>
<mxCell id="e_k0-discovery" value="멤버 등록" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-0" target="n_jgroups-ping">
<mxCell id="e_discovery-path" value="멤버 발견" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_replicas" target="n_discovery">
<mxGeometry relative="1" as="geometry">
<mxPoint x="330.0" y="123.0" as="offset"/>
<mxPoint x="375.0" y="139.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_k0-writes" value="세션 INSERT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-0" target="n_postgres">
<mxCell id="e_session-path" value="세션 저장 · 조회" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_replicas" target="n_session-store">
<mxGeometry relative="1" as="geometry">
<mxPoint x="324.0" y="229.2" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_k1-discovery" value="멤버 등록" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-1" target="n_jgroups-ping">
<mxGeometry relative="1" as="geometry">
<mxPoint x="330.0" y="203.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_k1-reads" value="세션 SELECT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-1" target="n_postgres">
<mxGeometry relative="1" as="geometry">
<mxPoint x="324.0" y="309.8" as="offset"/>
<mxPoint x="369.0" y="228.5" as="offset"/>
</mxGeometry>
</mxCell>
</root>