oto/agent-ops/roadmap/milestones/remote-run-lifecycle.md

원격 실행 생명주기

목표

Edge가 OTO agent에 파이프라인 실행을 요청하고, agent가 실행 진행 상황과 산출물을 보고하며, 취소와 상태 조회, self-update까지 이어지는 원격 실행 생명주기를 완성한다.

단계

메시지 기반 빌드 에이전트

상태

계획

범위

• run request를 기존 YAML 파이프라인과 커맨드 확장 모델에 연결한다.
• step event, log stream, artifact event를 원격 실행 흐름에 연결한다.
• cancel, status, self-update의 최소 동작과 실패 기준을 정의한다.
• agent 모드가 기존 CLI 실행 모델을 원격 제어 가능한 실행 표면으로 노출하게 한다.

필수 기능

• run request가 pipeline 실행 입력으로 변환되는 기준이 정의되어 있다.
• step event와 log stream이 원격 소비자에게 전달되는 흐름이 정의되어 있다.
• artifact event의 메타데이터와 전달 책임이 정의되어 있다.
• cancel, status, self-update 동작 기준이 정의되어 있다.

완료 기준

• Edge에서 요청한 빌드/배포 작업의 시작, 진행, 완료, 실패, 취소 상태를 추적할 수 있다.
• 기존 YAML 파이프라인과 커맨드 확장 모델을 유지하면서 원격 제어가 가능하다.
• self-update가 agent 안정성을 해치지 않도록 최소 실패 기준이 있다.

범위 제외

• YAML 파이프라인 언어를 새 DSL로 교체하지 않는다.
• generic remote shell agent로 확장하지 않는다.
• Edge 서버의 전체 스케줄링 정책을 구현하지 않는다.

작업 컨텍스트

• agent 메시지 프로토콜과 CLI 자동화 표면 정리 단계의 구조화 출력 기준을 먼저 확인한다.
• pipeline, command, core 도메인 rule이 관련될 수 있다.