55 lines
3.8 KiB
Markdown
55 lines
3.8 KiB
Markdown
# Workspace Ports
|
|
|
|
이 문서는 workspace 하위 프로젝트의 host publish port, dev preview port, wire port, test runner port를 한눈에 보기 위한 운영 표다.
|
|
컨테이너 내부 포트와 제품 기본 listen 포트는 가능한 유지하고, workspace 표준화 대상은 host publish, preview, remote runner 문서, smoke command로 둔다.
|
|
|
|
## 원칙
|
|
|
|
- 컨테이너 내부 포트는 각 제품/프레임워크의 표준값을 우선 유지한다.
|
|
- 외부 검증이나 원격 runner에서 이미 쓰는 포트는 바로 바꾸지 않고 프로젝트별 마일스톤에서 영향 범위를 확인한다.
|
|
- DB/Redis는 Docker network DNS를 우선하고, host publish가 필요한 경우에만 project offset 포트를 둔다.
|
|
- secret, token, password, private endpoint 원문은 tracked 문서에 쓰지 않는다.
|
|
- runtime service port가 없는 package는 포트 표준화 대상에서 제외한다.
|
|
- `proto-socket`처럼 운영 서버가 아니라 test runner가 고정 포트를 쓰는 경우는 예외 대역으로 문서화한다.
|
|
|
|
## 권장 대역
|
|
|
|
| 용도 | 대역 | 설명 |
|
|
|---|---:|---|
|
|
| Frontend / Web preview | `13000-13099` | Flutter Web, static preview, code-server proxy host port |
|
|
| Backend HTTP/API | `18000-18079` | 제품 API, core server, app backend host publish |
|
|
| Artifact/bootstrap/model HTTP | `18080-18099` | artifact server, bootstrap, Edge OpenAI-compatible, A2A HTTP |
|
|
| Wire / agent transport | `19000-19099` | proto-socket, Control Plane wire, Edge-Node TCP |
|
|
| Metrics / diagnostics | `19100-19199` | metrics, diagnostic HTTP/TCP. 기존 `1909x`는 migration 전까지 허용 |
|
|
| DB host publish | `15400-15499` | PostgreSQL host publish가 반드시 필요한 경우 |
|
|
| Cache host publish | `16300-16399` | Redis host publish가 반드시 필요한 경우 |
|
|
|
|
## 프로젝트별 슬롯
|
|
|
|
| 프로젝트 | Frontend / Preview | Backend / API | Artifact / Model | Wire / Agent Transport | Metrics | DB / Cache | 메모 |
|
|
|---|---:|---:|---:|---:|---:|---:|---|
|
|
| `iop` | `13000` | `18000` | `18080`, `18081` | `19080`, `19081`, `19090` | `19092` | `15400`, `16300` | 기존 field 포트 `18080`, `18081`, `19080`, `19090` 유지/변경 검토 |
|
|
| `nomadcode` | `13010` | `18010` | - | IOP 경유 | - | `15410`, `16310` | 기존 local core/default `8080` compatibility note 필요 |
|
|
| `oto` | `13020` | `18020` | - | - | - | - | 기존 local default `127.0.0.1:8080` compatibility note 필요 |
|
|
| `alt` | `13030` | `18030`, `18031` | - | `19030` optional | - | `15430`, `16330` | 기존 API/worker 포트와 migration note 필요 |
|
|
| `nexo` | `13040` | `18065`, `18066` 유지 | - | - | - | compose-internal 우선 | 변경 필요 시 `18040` 계열 후보. `18065/18066`은 compatibility baseline |
|
|
| `proto-socket` | - | - | - | test runner `29090-29899` | - | - | 운영 포트가 아니라 crosstest local fixed port 예외 |
|
|
|
|
## 제외 또는 host 의존
|
|
|
|
| 프로젝트 | 상태 | 메모 |
|
|
|---|---|---|
|
|
| `agent-shell` | 제외 | package 자체 포트 없음. host 앱이 환경을 소유한다. |
|
|
| `dart-app-core` | 제외 | library 자체 포트 없음. |
|
|
| `agentic-framework` | 제외 | 서버/runtime 포트 없음. 공통 agent-ops 문서 repo로만 본다. |
|
|
|
|
## 관련 마일스톤
|
|
|
|
| 프로젝트 | 마일스톤 |
|
|
|---|---|
|
|
| `alt` | `agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md` |
|
|
| `iop` | `agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md` |
|
|
| `nexo` | `agent-roadmap/phase/messaging-runtime/milestones/workspace-port-env-standardization.md` |
|
|
| `nomadcode` | `agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md` |
|
|
| `oto` | `agent-roadmap/phase/independent-control-plane/milestones/workspace-port-env-standardization.md` |
|
|
| `proto-socket` | `agent-roadmap/milestones/workspace-port-env-standardization.md` |
|