Files

192 lines
5.3 KiB
JSON

{
"version": "1.1",
"id": "dashboard-authority-loop",
"title": "UI 편집이 권위가 되지 못하는 자리",
"question": "대시보드를 UI 에서 고치면 왜 남지 않는가?",
"type": "architecture",
"direction": "LR",
"audience": [
"Grafana 를 쓰는 운영자",
"대시보드를 고치려는 사람"
],
"summary": "Git 의 JSON 이 desired state 이고, 사이드카가 ConfigMap 을 WATCH 해 파일로 떨군 뒤 Grafana file provider 가 30초마다 읽는다. UI 편집은 이 고리 밖이라 다음 동기화에서 덮인다.",
"alt": "Git JSON 이 desired state 로, 사이드카가 controller 로, Grafana 가 actual state 로 놓이고 파일 provider 가 30초마다 되돌리는 고리를 이루는 구조도. UI 편집은 이 고리 바깥에서 actual state 에만 닿는다.",
"long_description": "Git 저장소의 dashboard JSON 이 desired state 다. Kustomize 가 disableNameSuffixHash 로 안정 이름 ConfigMap 을 만들고 grafana_dashboard=1 label 을 붙인다. grafana-sc-dashboard 사이드카는 observability namespace 의 ConfigMap 을 list 와 watch 만 할 수 있는 Role 로 WATCH 하고, 변경을 /tmp/dashboards 에 반영한다. Grafana file provider 가 30초마다 그 디렉터리를 읽어 actual state 를 맞춘다. allowUiUpdates 는 false 이고 각 dashboard JSON 도 editable 이 false 라, 브라우저에서 고친 것은 이 고리에 들어가지 못하고 다음 동기화에서 덮인다. main Grafana 컨테이너는 ServiceAccount token 을 automount 하지 않으므로 Kubernetes API 로 스스로 상태를 되돌릴 수도 없다.",
"source_context": {
"document": "docs/platform-infra/final/document.md",
"document_sha256": "2831219e5510d6eff44e36eb652d6e63637490c23e193c9134510dad1d6bf226",
"anchor": {
"kind": "heading",
"value": "11.7 Grafana — Git 이 권위다",
"line": 1306
}
},
"composition": {
"profile": "reconciliation-loop",
"diagram_only": true,
"reference_ids": [
"declarative-vm"
],
"rationale": "본문 §11.7 은 desired state(Git JSON), watch 하는 주체(사이드카), actual state(Grafana), 그리고 30초마다 되돌리는 되먹임을 모두 적는다. 「UI 편집이 왜 안 남는가」는 고리의 바깥에 있다는 사실로만 설명되므로 reconcile 문법이 맞다.",
"focus_node": "sidecar"
},
"groups": [],
"nodes": [
{
"id": "git",
"label": "Git JSON",
"kind": "config",
"role": "desired-state",
"details": [
"안정 이름 ConfigMap",
"editable: false"
],
"evidence": [
{
"start_line": 1309,
"end_line": 1310
},
{
"start_line": 1321,
"end_line": 1323
}
],
"assumption": false,
"emphasis": "primary",
"shape": "box"
},
{
"id": "sidecar",
"label": "dashboard 사이드카",
"kind": "service",
"role": "controller",
"details": [
"ConfigMap watch 전용",
"Secret 권한 없음"
],
"evidence": [
{
"start_line": 1309,
"end_line": 1310
},
{
"start_line": 1317,
"end_line": 1319
}
],
"assumption": false,
"shape": "box"
},
{
"id": "grafana",
"label": "Grafana file provider",
"kind": "service",
"role": "actual-state",
"details": [
"/tmp/dashboards",
"scan 30s",
"allowUiUpdates: false"
],
"evidence": [
{
"start_line": 1309,
"end_line": 1310
},
{
"start_line": 1313,
"end_line": 1315
}
],
"assumption": false,
"shape": "box"
},
{
"id": "ui",
"label": "브라우저 UI 편집",
"kind": "actor",
"role": "status",
"details": [
"비권위 상태"
],
"evidence": [
{
"start_line": 1313,
"end_line": 1315
}
],
"assumption": false,
"shape": "box"
}
],
"edges": [
{
"id": "r1",
"from": "git",
"to": "sidecar",
"label": "생성",
"kind": "request",
"evidence": [
{
"start_line": 1309,
"end_line": 1310
}
],
"assumption": false
},
{
"id": "r2",
"from": "sidecar",
"to": "grafana",
"label": "WATCH",
"kind": "request",
"evidence": [
{
"start_line": 1309,
"end_line": 1310
},
{
"start_line": 1317,
"end_line": 1319
}
],
"assumption": false
},
{
"id": "r3",
"from": "grafana",
"to": "ui",
"label": "표시",
"kind": "response",
"evidence": [
{
"start_line": 1313,
"end_line": 1315
}
],
"assumption": false
},
{
"id": "r4",
"from": "ui",
"to": "git",
"label": "되돌릴 경로 없음",
"kind": "response",
"style": "dashed",
"evidence": [
{
"start_line": 1313,
"end_line": 1315
},
{
"start_line": 1317,
"end_line": 1319
}
],
"assumption": false,
"emphasis": "primary"
}
],
"legend": [],
"metadata": {}
}