136 lines
9.1 KiB
Markdown
136 lines
9.1 KiB
Markdown
tags: [infra, 24-server, robeing, operations, ssot, research]
|
|
|
|
# 260309 24서버 로빙 운영 자료 수집
|
|
|
|
- 상위 원칙: [0_VALUE Writing Principles](https://github.com/happybell80/0_VALUE/blob/main/02_Governance/writing-principles.md)
|
|
- 상위 원칙: [0_VALUE Global Principles](https://github.com/happybell80/0_VALUE/blob/main/00_Principles/global-principles.md)
|
|
|
|
## 목적
|
|
|
|
- 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` 순서로 읽는 것입니다.
|