adr snapshot to hostpath

ADR - AI Snapshot: Longhorn PVC에서 node-local hostPath로 전환

메타데이터	값
상태	accepted
결정일	2026-04-29
현재 유효 여부	유효
Superseded 관계	Longhorn RWO snapshot PVC 계획을 대체. 2026-06-08 S3 snapshot uploader가 장기 보존 경로를 후속 추가
구현 근거	Factory A AI workload의 /var/lib/safe-edge/snapshots hostPath, aegis-spoke snapshot uploader template
검증 근거	docs/ops/09_failover_failback_test_results.md test_07~09

Wiki ADR 파일명은 유지한다. 0001 충돌/통합 이력은 docs/changes/README.md와 파일명으로 식별한다.

---

결정

변경 전: /app/snapshots -> Longhorn RWO PVC
변경 후: /app/snapshots -> worker node /var/lib/safe-edge/snapshots hostPath

AI 추론 결과는 InfluxDB/Longhorn에 계속 저장한다. 이 결정은 snapshot image mount에만 적용한다.

---

이유

worker2가 격리되면 기존 Pod/VolumeAttachment가 남아 worker1의 AI Pod가 ContainerCreating과 Multi-Attach에 머물렀다. Snapshot 이미지는 추론 결과보다 복구 우선순위가 낮으므로, worker1 workload 재기동을 막지 않도록 node-local 저장으로 바꿨다.

---

결과

• test_07~09에서 AI/audio/BME worker1 failover와 worker2 failback 성공
• snapshot PVC Multi-Attach 재발 없음
• worker2 로컬 snapshot은 노드 장애 시 유실될 수 있음
• 현재 worker2 snapshot-uploader가 presigned PUT으로 S3 원본을 장기 저장

후속 uploader는 이 결정의 hostPath를 읽지만, worker1 upload failover를 추가하지는 않았다. uploader와 outbox는 worker2 단일 배치/RWO PVC 제약이 남아 있다.

---

운영 맥락: 모범사례와 실패사례 §1.4 · §6.1