Files
obsidian/history
kaffa 5be51134c9 incus-hp1 storage-net 참여 사실 반영 + kr2 multus-shim ETXTBSY 인시던트 기록
- infra-hosts.md: hp1 행 갱신 (이전 "1GbE only" → 2.5G 192.168.205.227, MAC 20:e1:5d:6a:2b:2e, MTU 9000 JF OK), 2.5G 표 hp1 행 추가, NAS NIC 정보(USB cdc_ncm → r8152 RTL8157 chip rev 14 + MAC)로 정확화, 호스트 자원 표에 hp1 추가, SSH 정보 라인에 hp1 접근 한계 명시
- nas-storage.md: K3s 노드 표 3→4 노드로 갱신 (hp1 추가), nodeAffinity 설명 표현 갱신
- history/2026-05-20-kr2-multus-shim-etxtbsy.md: ETXTBSY 데드락 RCA 및 `rm /opt/cni/bin/multus-shim` 회피책 기록
2026-05-20 17:10:07 +09:00
..

title, tags
title tags
History
history
changelog

인프라·서비스 변경 이력과 인시던트 기록. 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~~ 로 남긴 제거 항목, 인시던트 서사 금지.
  • 어떤 변경이든:
    1. 정본 파일에서 "현재 사실" 을 새 값으로 덮어쓴다
    2. history/YYYY-MM-DD-<주제>.md 에 상세 이력을 남긴다
    3. 정본에서 history 파일을 참조 링크로 연결할 수는 있으나, 이력 본문을 정본에 복제하지 않는다
  • git commit 히스토리는 정본 파일 변경을 자동으로 기록하므로 "이 줄이 왜 바뀌었는가" 는 git blame + 해당 commit 의 history 링크로 추적 가능하다.

왜 이렇게 분리하나

  • 정본이 log 가 되면 "지금 상태" 파악이 어려워진다
  • 변경 이력은 시간순이라 쌓이고, 정본은 시점 독립이라 덮어써진다 — 두 구조가 섞이면 안 됨
  • OpenMemory 와 Outline 도 유사한 시간축 기록 공간이지만, OpenMemory 는 시멘틱 검색용 요약, Outline 은 에이전트 간 대화 로그. history/ 는 인프라 변경의 정본 사본 (git 보관)