iop/agent-ops/roadmap/milestones/multi-edge-operations.md

Multi-Edge 운영

목표

여러 Edge group을 관찰하고 운영하는 fleet-level 기능을 구축한다. Multi-edge scheduling과 fleet-wide state ownership은 Control Plane과 IOP native protocol에서 결정한다.

단계

Control Plane과 Portal 운영

상태

계획

구현 잠금

• 상태: 잠금
• 이유: fleet-level 운영 책임 경계를 정리하는 게이트 문서이며, multi-edge scheduling과 state ownership 세부 기준이 아직 확정되지 않았다.
• 해제 조건:
  • multi-edge 상태 조회, 실행 이력 집계, routing/scheduling 책임 경계가 문서화됨
  • Control Plane과 Edge의 상태 소유권 기준이 구체화됨
  • 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함
• 잠금 중 금지:
  • 코드 구현 또는 agent-task 구현 계획 생성
  • Edge federation, scheduling algorithm, DB schema를 추측해 확정
  • Control Plane이 Node를 직접 할당하는 구조 선확정

범위

• 여러 Edge group 등록/상태 표시
• Edge별 runtime/automation 상태 집계
• Edge 단위 실행 이력과 event aggregation
• Edge 단위 작업 실행과 제어
• OTO 같은 domain agent의 build/deploy 상태, artifact, capability 포함
• fleet-wide 명령과 운영 리포트 후보

필수 기능

• [native-fleet] Multi-edge 운영 명령과 이벤트 집계는 IOP native protocol을 기준으로 설계한다.
• [openai-routing] OpenAI-compatible 표면은 특정 Edge/adapter로 라우팅되는 inference 호환 경로로 제한한다.
• [a2a-routing] A2A 표면은 특정 Edge/adapter로 위임되는 agent task 경로로 제한한다.
• [edge-ownership] Edge는 자신의 로컬 런타임 상태와 registry 소유권을 유지한다.

완료 기준

• Control Plane이 여러 Edge 상태를 구분해 조회하고 표시할 수 있다.
• Edge별 실행 이력과 domain agent 상태가 운영 화면에서 구분된다.
• fleet-wide 기능이 Edge의 로컬 상태 소유권을 침범하지 않는다.

범위 제외

• Control Plane이 매 요청마다 Node를 직접 할당하는 중앙 스케줄러 역할
• OpenAI-compatible API 또는 A2A API를 multi-edge 운영 제어 기본 프로토콜로 사용
• Edge federation 상세 설계를 근거 없이 선확정

작업 컨텍스트

• 관련 앱: apps/control-plane, apps/web, apps/edge
• 관련 문서: docs/architecture.md
• 선행 Milestone: Control Plane과 Portal, 정책, 이력, 감사