ivada-infra/DOCS
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
DOCS/journey/research/260307_value_기준_인프라철학문서_구조초안.md

3.5 KiB
Raw Permalink Blame History

260307 value 기준 인프라철학문서 구조초안

목적

  • infra 프로젝트의 철학 문서를 쓰기 전에, 어떤 상위 원칙과 타 프로젝트 문서 패턴을 가져와야 하는지 정리한다.
  • 인프라 프로젝트에 맞는 DOCS 상위 구조를 초안 수준으로 고정한다.

이번에 참고한 기준 문서

0_VALUE

  • /home/admin/0_VALUE/00_Principles/global-principles.md
  • /home/admin/0_VALUE/00_Principles/vision.md
  • /home/admin/0_VALUE/02_Governance/system-and-infrastructure-overview.md
  • /home/admin/0_VALUE/02_Governance/infrastructure-ssot-principle.md

robeing

  • /home/admin/robeing/DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md
  • /home/admin/robeing/DOCS/book/300_architecture/314_infrastructure-ssot-principle.md
  • /home/admin/robeing/DOCS/journey/plans/260303_23테스트보조_24프로덕션_운영전환_계획.md
  • /home/admin/robeing/DOCS/journey/troubleshooting/260307_NAS_192_168_0_101_SSOT_전환_및_CIFS_실마운트_복구.md
  • /home/admin/robeing/DOCS/journey/troubleshooting/260226_NAS_192_168_219_51_접속불가_임시백업복구.md
  • /home/admin/robeing/DOCS/journey/troubleshooting/260303_51123_gateway_rb8001_연결점검_23서버_전달사항.md

projectStarsAndI

  • /home/admin/projectStarsAndI/DOCS/journey/research/260221_23_24_NAS_게이트웨이_운영구성_정리.md

구조 참고용 프로젝트

  • /home/admin/TheGooseCouncil/DOCS/README.md
  • /home/admin/goosefarminvesting/DOCS/README.md
  • /home/admin/robeing/DOCS/README.md

공통으로 추출된 인프라 철학 키워드

  1. 역할 분리
  • 23은 진입/제어, 24는 실행, NAS는 보존/복구
  1. 지속성
  • 가치 있는 상태는 서버 메모리나 사람 기억에만 남아 있으면 안 된다.
  1. SSOT
  • IP, 포트, 업스트림, 마운트, 비밀값은 한 번만 정의해야 한다.
  1. 검증 우선
  • 설정 변경이 아니라 실응답, 실마운트, 실로그로 판단한다.
  1. 게이트웨이 중심
  • 외부 요청은 단일 진입점에서 먼저 인증/라우팅/관측 가능해야 한다.
  1. 실패의 가시성
  • 장애를 덮지 않고, 원인 분리와 복구 가능성을 남겨야 한다.

인프라 프로젝트에 맞는 문서 구조 판단

다른 제품 프로젝트의 전략/제품 중심 구조를 그대로 가져오는 것은 맞지 않았다.

인프라는 제품 개념보다 운영 지속성이 본질이므로, 아래 구조가 가장 적합하다고 판단했다.

  1. 00_Philosophy
  • 왜 이 인프라를 운영하는가
  • 무엇을 지켜야 하는가
  • 무엇을 금지하는가
  1. 02_Architecture
  • 23/24/NAS와 보조 자산이 어떻게 나뉘는가
  • 무엇이 핵심 자산이고 무엇이 보조 자산인가
  1. journey
  • 실제 변경, 장애, 점검, 복구 기록

이번 초안에서 보류한 항목

  1. 개발 노트북/테스트 스마트폰/외부 NAS의 상세 운영 원칙
  • 이유: 현재 철학 문서의 중심축은 23/24/내부 NAS이기 때문
  1. 세부 인벤토리 표
  • 이유: 철학 문서보다 구조 문서에서 관리하는 편이 맞기 때문
  1. 장기 로드맵 폴더
  • 이유: 현재 단계에서는 journey/plans로 충분하고, 고정 계층으로 분리할 정도로 안정화되지 않았기 때문

이번 작업의 결론

  • infra 프로젝트의 본문은 23/24/NAS 중심으로 쓴다.
  • 주변 자산은 보조 실행 환경으로 분리한다.
  • 문서 구조는 철학 -> 구조 -> journey 삼층으로 유지한다.