oto/agent-ops/roadmap/milestones/edge-bootstrap-contract.md

Edge bootstrap 계약

목표

Jenkins node 연결식 UX를 Edge 중심 bootstrap 경험으로 재해석한다. Edge에서 OTO agent를 생성하고 대상 머신에서 실행할 bootstrap command를 발급하는 UX와 설치/등록 계약을 정의한다.

단계

Edge bootstrap 기반 oto-agent

상태

계획

범위

• Jenkins node를 연결하듯 Edge에서 agent 생성과 bootstrap command 발급을 시작하는 사용자 흐름을 정의한다.
• Edge가 발급하는 bootstrap command의 입력, 출력, 만료, 재시도 정책을 정의한다.
• 대상 머신의 OS/arch에 맞는 OTO 바이너리 설치 경로를 정리한다.
• agent 설정 파일 생성 위치와 최소 설정 값을 정의한다.
• HTTPS 기본 권장, HTTP local/insecure 허용 범위, 폐쇄망 사용 조건을 구분한다.

필수 기능

• Edge에서 agent 생성 후 bootstrap command를 발급하는 사용자 흐름이 정의되어 있다.
• bootstrap command 형식과 필수 인자가 정의되어 있다.
• OS/arch별 바이너리 선택 규칙이 정의되어 있다.
• agent 설정 생성 경로와 필수 설정 값이 정의되어 있다.
• HTTPS, HTTP local, insecure 모드의 허용 조건이 문서화되어 있다.

완료 기준

• Jenkins node 연결식 경험과 비교해 사용자가 Edge bootstrap 흐름을 이해할 수 있다.
• 사용자가 Edge에서 발급받은 command 하나로 대상 머신에 OTO agent 설치를 시작할 수 있는 흐름이 설명된다.
• 보안 모드별 요구 사항과 위험이 구분되어 구현 전에 검토 가능하다.
• 폐쇄망 배포와 개발망 테스트가 같은 계약 안에서 설명된다.

범위 제외

• 실제 Edge 서버 API를 구현하지 않는다.
• 메시지 기반 run request 프로토콜을 구현하지 않는다.
• iop-node 연동을 추가하지 않는다.

작업 컨텍스트

• 기존 packaging 자료와 설치 스크립트(assets/package/**, assets/script/**)를 먼저 확인한다.
• framework, cli 도메인 rule이 관련될 수 있다.