ivada-infra/DOCS
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
DOCS/journey/research/260309_24서버_로빙운영_자료수집.md

9.1 KiB
Raw Blame History

tags: [infra, 24-server, robeing, operations, ssot, research]

260309 24서버 로빙 운영 자료 수집

목적

  • 24 서버를 로빙 실행 서버로 운영할 때 먼저 봐야 할 문서를 SSOT 순서대로 모읍니다.
  • 문서만 모으지 않고, 현재 워크스페이스에서 실제 실행 자산이 어디에 있는지 함께 확인합니다.
  • 상위 SSOT와 충돌하는 하위 문서/값도 같이 표시해 운영 기준이 흔들리지 않게 합니다.

Facts

1. 최상위 철학 SSOT는 0_VALUE다

  • 0_VALUE/README.md: 0_VALUE를 전 프로젝트 공통 SSOT 저장소로 정의합니다.
  • 0_VALUE/00_Principles/global-principles.md: Value First, Truth First, Trust by Design, Continuity를 공통 철학으로 고정합니다.
  • 0_VALUE/01_Framework/value-measurement-framework.md: 모든 작업을 가치평가 체계 구축의 일부로 해석합니다.
  • 0_VALUE/02_Governance/governance-adoption-guide.md: 공통 규칙은 0_VALUE에 두고, 프로젝트 문서에는 예외만 남기라고 정의합니다.

2. 인프라 SSOT는 infra/DOCS다

  • infra/DOCS/00_Philosophy/00_IDENTITY/Infra_Project_Identity.md: 인프라 프로젝트를 23 서버 / 24 서버 / 내부 NAS를 하나의 운영 시스템으로 유지하는 프로젝트로 정의합니다.
  • infra/DOCS/02_Architecture/Infrastructure_Project_Structure.md: 23은 진입/제어면, 24는 실행면, NAS는 보존/복구면으로 구분합니다.
  • infra/DOCS/00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md: 역할 문구를 문서와 설정에서 동일하게 유지하고, 서버 이전/IP 변경은 SSOT 변경으로 먼저 다루라고 명시합니다.

3. 24 서버 운영에 직접 필요한 인프라 문서는 아래 순서다

  1. infra/DOCS/00_Philosophy/00_IDENTITY/Infra_Project_Identity.md
  2. infra/DOCS/02_Architecture/Infrastructure_Project_Structure.md
  3. infra/DOCS/00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md
  4. infra/DOCS/journey/troubleshooting/260309_24서버_우분투터미널불가_네트워크대역오류_python3apt복구.md
  5. infra/DOCS/journey/troubleshooting/260307_NAS_192_168_0_101_SSOT_전환_및_CIFS_실마운트_복구.md
  6. infra/DOCS/journey/troubleshooting/260307_gateway_SSOT_runtime_secrets_분리_적용_및_검증.md
  7. infra/DOCS/journey/troubleshooting/260303_51123_gateway_rb8001_연결점검_23서버_전달사항.md
  8. infra/DOCS/journey/troubleshooting/260305_23임시배포_envdeploy_ssot_및_배포실패_근본원인_해결.md

4. 24 서버 현재 운영 IP 관련 최신 근거는 인프라 journey에 있다

  • infra/DOCS/journey/troubleshooting/260309_24서버_우분투터미널불가_네트워크대역오류_python3apt복구.md: 2026-03-09 기준 24 서버 활성 주소가 192.168.0.106으로 정리됐고, 과거 192.168.219.52는 병행 허용하면 안 된다고 기록합니다.
  • 같은 문서는 23에서 24로 향하는 URL, 24 내부 자기참조 URL, 배포 스크립트, health check 예시도 192.168.0.106 또는 의미 있는 환경변수만 보게 정리해야 한다고 명시합니다.

5. 로빙 프로젝트의 운영 예외 문서는 robeing에 있다

  • robeing/AGENTS.md: 24 서버 전담 개발/배포/검증 규칙을 담고 있습니다.
  • robeing/DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md: 서비스 구성과 포트 구조를 설명합니다.
  • robeing/DOCS/book/300_architecture/311_백엔드_구조_원칙.md: 서비스 수정 시 따라야 할 코드 구조 원칙입니다.
  • robeing/DOCS/book/300_architecture/312_writing-principles.md: robeing 내부 문서화 예외 규칙입니다.
  • robeing/DOCS/book/300_architecture/guidelines/deployment_patterns.md: 자동/수동 배포, 검증 원칙을 짧게 정리합니다.
  • robeing/DOCS/book/300_architecture/325_robeing_monitor_모니터링_아키텍처.md: 운영 관측 계층 계약을 설명합니다.
  • robeing/DOCS/journey/plans/260303_23테스트보조_24프로덕션_운영전환_계획.md: 23 검증 -> 24 반영 -> 장애 시 23 임시수용 운영 플로우를 정의합니다.
  • robeing/DOCS/journey/troubleshooting/260303_9024_health_endpoint_alignment.md: monitor 헬스 경로 정합 이슈를 기록합니다.

6. 실제 실행 자산은 robeing 저장소 하위에 존재한다

  • Compose 파일 확인 경로:
    • robeing/rb8001/docker-compose.yml
    • robeing/robeing-monitor/docker-compose.yml
    • robeing/skill_email/docker-compose.yml
    • robeing/skill_news/docker-compose.yml
    • robeing/skill-slack/docker-compose.yml
    • robeing/skill-rag-file/docker-compose.yml
    • robeing/skill-calendar/docker-compose.yml
    • robeing/skill-embedding/docker-compose.yml
    • robeing/skill-publish/docker-compose.yml
  • 자동배포 흔적 확인 경로:
    • robeing/rb8001/.gitea/
    • robeing/robeing-monitor/.gitea/
    • robeing/skill_email/.gitea/
    • robeing/skill_news/.gitea/
    • robeing/skill-slack/.gitea/
    • robeing/skill-rag-file/.gitea/
    • robeing/frontend-customer/.gitea/
    • robeing/frontend-ir-valuation/.gitea/

7. 헬스체크 경로는 서비스별로 이미 혼합되어 있다

  • robeing/rb8001/docker-compose.yml: http://localhost:8001/health
  • robeing/robeing-monitor/docker-compose.yml: http://localhost:9024/healthz
  • robeing/skill_email/docker-compose.yml: http://localhost:8501/health
  • robeing/skill_news/docker-compose.yml: http://localhost:8505/health
  • robeing/skill-calendar/docker-compose.yml: http://localhost:8512/health
  • robeing/skill-embedding/docker-compose.yml: http://localhost:8515/healthz

8. SSOT 관점에서 바로 보이는 충돌/공백이 있다

  • robeing/AGENTS.md는 아직 192.168.219.52, 192.168.219.45, /home/admin/ivada_project/...를 기준으로 설명합니다.
  • robeing/DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md와 325_robeing_monitor_모니터링_아키텍처.md도 과거 IP 기준 설명을 유지합니다.
  • /home/admin/infra-config/runtime.env는 현재 이 24 서버 워크스페이스에 존재하지 않습니다. 인프라 구조 문서에서는 infra-config를 보조 SSOT 자산으로 정의하지만, 실제 파일은 확인되지 않았습니다.

Interpretation

  • 24 서버 운영 자료의 기준 축은 이미 있습니다. 판단 기준은 0_VALUE, 역할 기준은 infra/DOCS, 서비스 예외와 실행 자산은 robeing 순으로 읽으면 됩니다.
  • 다만 24 서버의 최신 IP와 경로 정리는 아직 infra/DOCS/journey 쪽이 가장 최신입니다. robeing 하위 문서는 운영 규칙은 유용하지만 주소/경로는 일부 과거값을 유지합니다.
  • 따라서 지금 24 서버를 운영할 때는 robeing/AGENTS.md를 그대로 SSOT처럼 쓰면 안 되고, 철학/역할/IP는 infra/DOCS의 2026-03-09 이후 문서를 우선해야 합니다.

운영용 최소 읽기 묶음

A. 왜 이 서버를 운영하는가

  1. 0_VALUE/00_Principles/global-principles.md
  2. 0_VALUE/01_Framework/value-measurement-framework.md

B. 23/24/NAS를 어떻게 구분하는가

  1. infra/DOCS/00_Philosophy/00_IDENTITY/Infra_Project_Identity.md
  2. infra/DOCS/02_Architecture/Infrastructure_Project_Structure.md
  3. infra/DOCS/00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md

C. 24 서버에서 당장 뭘 봐야 하는가

  1. infra/DOCS/journey/troubleshooting/260309_24서버_우분투터미널불가_네트워크대역오류_python3apt복구.md
  2. infra/DOCS/journey/troubleshooting/260307_NAS_192_168_0_101_SSOT_전환_및_CIFS_실마운트_복구.md
  3. infra/DOCS/journey/troubleshooting/260307_gateway_SSOT_runtime_secrets_분리_적용_및_검증.md
  4. robeing/AGENTS.md
  5. robeing/DOCS/book/300_architecture/guidelines/deployment_patterns.md

D. 실제 수정/배포 전에 봐야 하는 실행 자산

  1. 각 서비스 docker-compose.yml
  2. 각 서비스 .gitea/workflows/*
  3. robeing/DOCS/book/300_architecture/311_백엔드_구조_원칙.md
  4. robeing/DOCS/book/300_architecture/325_robeing_monitor_모니터링_아키텍처.md

Unresolved

  • 24 서버 주소의 SSOT 파일이 infra-config에도 반영됐는지 이 서버에서는 확인하지 못했습니다. 로컬에 infra-config/runtime.env가 없습니다.
  • robeing/AGENTS.md와 robeing 아키텍처 문서가 새 주소/경로 기준으로 갱신되지 않아, 현재는 참고 문서이되 최신 SSOT는 아닙니다.
  • 자동배포 레포와 수동배포 레포 구분은 robeing/AGENTS.md에 있으나, 실제 .gitea/workflows와 완전히 일치하는지 서비스별 대조는 아직 하지 않았습니다.

한 줄 결론

  • 24 서버 로빙 운영 자료는 이미 흩어진 채 존재하고 있고, 현재 기준 정답은 0_VALUE -> infra/DOCS -> robeing/AGENTS/DOCS -> 실제 compose/workflow 순서로 읽는 것입니다.