DOCS/book/300_architecture/reference/infrastructure.md
Claude-51124 46baeaff91 docs: 개발 참조 문서 추가 (reference/)
- API 엔드포인트 정리 (api_endpoints.md)
- 인프라 정보 정리 (infrastructure.md)
- 환경변수 정리 (environment_variables.md)
- 배포 파이프라인 정리 (deployment_pipelines.md)
- 상수/설정값 정리 (constants.md)
- 네이밍 컨벤션 정리 (naming_conventions.md)
- 로깅 규칙 정리 (logging_rules.md)

목적: 개발 시 중복/오류 방지, 빠른 참조
모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용
2025-12-06 13:28:46 +09:00

97 lines
2.7 KiB
Markdown

# 인프라 참조
**작성일**: 2025-12-06
**목적**: 서버/포트/네트워크 정보 빠른 참조
---
## 서버 구성
| 서버 | IP | 역할 | 주요 서비스 |
|------|-----|------|------------|
| 51123 | 192.168.219.45 | 메인 서버 | nginx, Gitea, auth-server, robeing-gateway, frontend-base, PostgreSQL |
| 51124 | 192.168.219.52 | 로빙/스킬 서버 | rb8001, robeing-monitor, skill-*, ChromaDB |
**참고**: `AGENTS.md:78-81`, `DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md:27-30`
---
## 포트 매핑
### 51123 서버
| 서비스 | 포트 | 프로토콜 | 설명 |
|--------|------|----------|------|
| nginx | 80, 443 | HTTP/HTTPS | 웹 서버 |
| Gitea | 3000 | HTTP | Git 저장소 |
| robeing-gateway | 8100 | HTTP | API 게이트웨이 |
| frontend-base | 8000 | HTTP | 관리자 대시보드 |
| auth-server | 9000 | HTTP | 인증 서버 |
| PostgreSQL | 5432 | TCP | 데이터베이스 |
| Neo4j | 7687 | TCP | 그래프 DB |
### 51124 서버
| 서비스 | 포트 | 프로토콜 | 설명 |
|--------|------|----------|------|
| rb8001 | 8001 | HTTP | 메인 로빙 서비스 |
| robeing-monitor | 9024 | HTTP | 모니터링 서비스 |
| skill-email | 8501 | HTTP | 이메일 스킬 |
| skill-news | 8505 | HTTP | 뉴스 스킬 |
| skill-slack | 8502 | HTTP | Slack 스킬 |
| skill-rag-file | 8508 | HTTP | RAG 파일 스킬 |
| skill-calendar | 8512 | HTTP | 캘린더 스킬 |
| skill-embedding | 8511 | HTTP | 임베딩 스킬 |
| skill-publish | - | HTTP | 퍼블리싱 스킬 |
| ChromaDB | 8000 | HTTP | 벡터 DB |
**참고**: `AGENTS.md:78-81`, 각 서비스 `docker-compose.yml`
---
## 네트워크 플로우
### 배포 플로우
```
로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작
```
**참고**: `AGENTS.md:83-85`
### Admin Dashboard 라우팅
```
사용자 → nginx (51123) → robeing-gateway (8100) → frontend-base (8000)
```
**참고**: `AGENTS.md:88-92`
### API 프록시
```
Frontend → nginx (/gateway/) → Gateway (8100) → 각 서비스
```
---
## SSH 접속
| 서버 | SSH 포트 | 사용자 | 용도 |
|------|----------|--------|------|
| 51124 | 51124 | admin | 배포 (Gitea Actions) |
**참고**: `AGENTS.md:28-29`, Gitea Actions 워크플로우
---
## 데이터베이스
| DB | 서버 | 포트 | 데이터베이스명 | 사용자 |
|----|------|------|---------------|--------|
| PostgreSQL | 51123 | 5432 | main_db | robeings |
| Neo4j | 51123 | 7687 | - | neo4j |
| ChromaDB | 51124 | 8000 | - | - |
**참고**: `DOCS/book/300_architecture/database/tables.md`
---
**업데이트**: 서버/포트 변경 시 즉시 반영