workspace-manager/.workspace-ops/docs/remote-runners.md

3.9 KiB

Workspace Remote Runners

이 문서는 workspace 하위 프로젝트에서 확인된 원격 runner, remote runtime path, field endpoint 성격을 정리한다. 접속 credential, token, private key, secret 값은 기록하지 않는다.

원격 runner 표

프로젝트 접속/호스트 원격 경로 용도 메모
alt ssh toki@toki-labs.com ~/agent-work/alt ALT 테스트/원격 작업 runner KIS live smoke와 private testing env 값은 tracked 문서에 쓰지 않는다.
iop ssh toki@toki-labs.com /Users/toki/agent-work/iop-dev Control Plane/Edge/Node/Client remote validation Docker-in-Docker 없이 remote host/runtime 기준으로 검증한다.
nexo ssh toki@toki-labs.com repo ~/agent-work/nexo, compose ~/docker/agent-service/nexo/compose Mattermost core/push-proxy runtime validation core 18065, push-proxy 18066은 compatibility baseline으로 둔다.
nomadcode remote Android runner host $HOME/agent-work/nomadcode Flutter/Android runner, sibling package integration ../nexo/packages/messaging_flutter, ../proto-socket/dart sibling dependency를 전제로 한다.
gito ssh toki@toki-labs.com $HOME/agent-work/gito Core Go, Flutter client, provider webhook/proto-socket, agent-shell runner validation 기본 local 테스트 evidence는 remote runner 기준이다. Core internal/default 8080은 유지하고 host 검증은 18060을 사용한다.
appsok ssh toki@toki-labs.com $HOME/docker/services/code-server/data/volume/workspace/appsok Flutter macOS/Xcode/ADB/Jenkins remote validation Flutter web preview가 필요하면 13050을 사용한다.
proto-socket ssh toki@toki-labs.com ~/agent-work/proto-socket-dart-web Dart web/Chrome fallback, WSS/SPKI wrapper runtime service가 아니라 test harness 예외다.
oto ssh toki@toki-labs.com /Users/toki/agent-work/oto OTO runner/Core/client remote validation 기본 local 테스트 evidence는 remote runner 기준이다. Core 18020, Flutter web preview 13020을 project-owned slot으로 사용한다.

Remote / Field 포트 기준

프로젝트 포트/URL 성격
iop artifact/bootstrap HTTP 18080
iop Edge OpenAI-compatible HTTP 18081
iop Control Plane wire 19080
iop Edge-Node / Edge runtime TCP 19090
iop metrics 기존 field 계열 19092
alt field frontend/dev preview reserve 13000-13099
alt field artifact/bootstrap 18080
alt field Edge OpenAI-compatible 18081
alt field CP wire / Edge runtime 19080, 19090
alt field metrics / specialized reserve 19092, 19190
nexo external core HTTP 18065
nexo push-proxy HTTP 18066
appsok Flutter web preview when needed 13050
gito Flutter/code-server preview when needed 13060
gito Core HTTP host publish/direct smoke 18060
gito optional proto-socket/agent transport split 19060
gito PostgreSQL/Redis host publish candidates 15460, 16360
oto Core HTTP host publish 18020
oto Flutter web preview when needed 13020
proto-socket crosstest local fixed port range 29090-29899

운영 메모

  • 원격 포트는 문서 정리만으로 바꾸지 않는다. 변경 전에는 해당 프로젝트 마일스톤에서 smoke, client config, remote runner path를 같이 확인한다.
  • field/runtime 포트와 local development 후보 포트가 다를 수 있다. 이 경우 field 포트를 compatibility baseline으로 먼저 둔다.
  • proto-socket의 remote runner는 제품 runtime이 아니라 Dart web/Chrome test harness 보조 경로다.
  • private host 값은 이미 공개된 host 별칭 수준만 기록하고, credential이나 token은 기록하지 않는다.