2356b86d36
15개 정본 문서에서 날짜별 변경이력, 인시던트 기록, 폐기된 구현 상세를 history/ 디렉토리로 분리. 정본은 현재 상태만 기술하는 백서 형태로 정리. 각 정본에 history 위키링크 추가. 분리된 history 파일 12건: - apisix git push 500, k3s postgresql migration, apisix→traefik 전환 - netbis DDoS 공격, gitea 이전/분리, usb 2.5g hang + NFS hard mount - supabase→patroni, apisix etcd 통합/분리, anomaly-detect 재설계 - patroni failover incident, zlambda nixos migration, ops-agents setup Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
title, tags
| title | tags | ||
|---|---|---|---|
| History |
|
인프라·서비스 변경 이력과 인시던트 기록. Obsidian 정본 파일은 "지금 이게 맞다" 형태의 백서이고, 여기 history/ 는 "무엇이 어떻게 변했는가" 를 남기는 별도 공간.
파일 규칙
- 파일명:
YYYY-MM-DD-<주제>.md(예:2026-04-10-edge-cleanup.md) - 하나의 이벤트 = 하나의 파일. 관련된 조치들이 하루에 연쇄로 일어난 경우 한 파일로 묶어도 됨.
- Frontmatter:
date,topic,areas(관련 Obsidian 정본 파일 경로),tags - 본문:
## 배경— 왜 이 변경이 필요했는가## 변경 사항— 무엇을 어떻게 바꿨는가 (before → after)## 영향 / 검증— 사용자 영향, 실측 검증 결과## 교훈 (있으면)— 인시던트였다면 원인 + 재발 방지## 참조— Outline doc, OpenMemory id, 관련 정본 파일 링크
정본과의 관계
- 정본 (
infra/,services/,products/, ...) 에는 현재 사실만. "2026-04-DD X→Y 변경" 같은 연대기 주석,~~strikethrough~~로 남긴 제거 항목, 인시던트 서사 금지. - 어떤 변경이든:
- 정본 파일에서 "현재 사실" 을 새 값으로 덮어쓴다
history/YYYY-MM-DD-<주제>.md에 상세 이력을 남긴다- 정본에서 history 파일을 참조 링크로 연결할 수는 있으나, 이력 본문을 정본에 복제하지 않는다
- git commit 히스토리는 정본 파일 변경을 자동으로 기록하므로 "이 줄이 왜 바뀌었는가" 는
git blame+ 해당 commit 의 history 링크로 추적 가능하다.
왜 이렇게 분리하나
- 정본이 log 가 되면 "지금 상태" 파악이 어려워진다
- 변경 이력은 시간순이라 쌓이고, 정본은 시점 독립이라 덮어써진다 — 두 구조가 섞이면 안 됨
- OpenMemory 와 Outline 도 유사한 시간축 기록 공간이지만, OpenMemory 는 시멘틱 검색용 요약, Outline 은 에이전트 간 대화 로그.
history/는 인프라 변경의 정본 사본 (git 보관)