4.3 KiB
4.3 KiB
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 (dev:13001) |
18000 (dev:18001) |
18080, 18081 (dev 후보:18082/18083) |
19080, 19081, 19090 (dev:19001/19002/19003) |
19092 (dev 후보:19101) |
15400, 16300 (dev:15401/16301) |
기존 field 포트 18080, 18081, 19080, 19090 유지. dev profile은 .env.dev.example 기준 |
nomadcode |
13010 |
18010 |
- | IOP 경유 | - | 15410, 16310 |
기존 local core/default 8080 compatibility note 필요 |
oto |
13020 |
18020 |
- | OTO-owned slot 미확정 | - | - | 기본 local 테스트 evidence는 /Users/toki/agent-work/oto 원격 runner 기준. 기존 product default 127.0.0.1:8080은 compatibility fallback |
alt |
13030 |
18030, 18031 |
- | 19030 optional |
- | 15430, 16330 |
기존 API/worker 포트와 migration note 필요 |
nexo |
13040 |
18065, 18066 유지 |
- | - | - | compose-internal 우선 | 변경 필요 시 18040 계열 후보. 18065/18066은 compatibility baseline |
appsok |
13050 |
- | - | - | - | - | remote Mac runner 중심. 일반 Flutter/macOS build는 public port 없음 |
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 |
appsok |
현재 workspace-level inventory로 관리. 프로젝트 milestone 확인 시 추가 |