iop/agent-roadmap/phase/automation-runtime-bridge/milestones/oto-bootstrap-command-issue.md

Milestone: OTO Bootstrap Command 발급

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/automation-runtime-bridge/PHASE.md

목표

iop-edge가 OTO agent record를 생성하고 대상 Linux host에서 바로 실행할 one-line bootstrap command를 발급한다. Edge는 OTO bootstrap script를 구현하지 않고, OTO가 소유한 script 인자와 release asset 계약을 소비하는 command를 만든다.

상태

[계획]

구현 잠금

• 상태: 해제
• 결정 필요: 없음

범위

• iop-edge CLI에 OTO agent registration 또는 agent bootstrap command 발급 표면을 추가한다.
• Edge config에 OTO agent id, alias, enrollment token, release base URL, bootstrap script URL을 기록하거나 재생성 가능한 구조를 둔다.
• 출력 command는 OTO Linux MVP bootstrap 인자와 일치해야 한다.
• local/dev HTTP bootstrap은 명시 flag가 있을 때만 허용하고, 기본 출력은 HTTPS URL을 우선한다.

기능

Epic: [command-surface] Edge CLI Command Surface

Edge-local field UX에서 OTO agent를 생성하고 bootstrap command를 출력한다.

• [agent-register-cmd] iop-edge가 OTO agent record를 만들거나 갱신하는 command 표면을 제공한다.
• [bootstrap-output] command 출력은 한 줄 bootstrap command만 안정적으로 제공하고 token을 불필요하게 재출력하지 않는다.
• [oto-args] 출력 command가 OTO bootstrap 필수 인자 --edge-url, --agent-id, --enrollment-token, --release-base-url을 포함한다.
• [config-roundtrip] 생성된 edge config를 config check와 runtime load가 읽을 수 있다. 검증: go test ./apps/edge/cmd/edge ./packages/go/config

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 모든 기능 Task가 아직 충족되지 않았다.
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• OTO bootstrap script 자체 구현
• OTO release asset 빌드/업로드 자동화
• checksum/signature 강제 검증
• Control Plane 원격 발급 UI

작업 컨텍스트

• 관련 경로: apps/edge/cmd/edge/main.go, packages/go/config, configs/edge.yaml, ../oto/assets/script/shell/oto_agent_bootstrap.sh
• 표준선(선택): command 형식은 curl -fsSL "${OTO_BOOTSTRAP_URL}" | bash -s -- --edge-url "${EDGE_URL}" --agent-id "${AGENT_ID}" --enrollment-token "${ENROLLMENT_TOKEN}" --release-base-url "${OTO_RELEASE_BASE_URL}" --agent-alias "${AGENT_ALIAS}"를 기준으로 한다.
• 표준선(선택): MVP에서는 one-time enrollment token을 사용하고 장기 credential 재발급은 후속으로 둔다.
• 선행 작업: OTO Agent Registry 구현
• 후속 작업: OTO Registration Online Smoke
• 확인 필요: local smoke에서 사용할 OTO bootstrap script URL과 release base URL 기본값