- API 엔드포인트 정리 (api_endpoints.md) - 인프라 정보 정리 (infrastructure.md) - 환경변수 정리 (environment_variables.md) - 배포 파이프라인 정리 (deployment_pipelines.md) - 상수/설정값 정리 (constants.md) - 네이밍 컨벤션 정리 (naming_conventions.md) - 로깅 규칙 정리 (logging_rules.md) 목적: 개발 시 중복/오류 방지, 빠른 참조 모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용
97 lines
2.7 KiB
Markdown
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`
|
|
|
|
---
|
|
|
|
**업데이트**: 서버/포트 변경 시 즉시 반영
|
|
|