핵심 개념
Deplite는 노드에 미리 선언한 동작만 이름으로 호출해요.
호출은 POST /v1/run/{agentName}/{workflowName}로 전달되고, 요청 1회마다 Job 하나가 만들어져요.
Organization
조직은 Agent와 API 토큰을 관리하는 범위예요.
토큰은 조직의 owner가 발급할 수 있어요.
Agent
서버나 기기에 설치되어 워크플로우를 실행하는 노드예요.
Agent 이름은 조직 안에서 유일해야 하며, 대소문자를 구분해 정확히 일치해야 해요.
Workflow
Agent에서 실행할 동작을 YAML로 선언해요.
실행 내용은 노드의 워크플로우 파일이나 기기의 핸들러에 있고, Deplite에는 이름과 호출 허용 여부를 전달해요.
외부에서 호출하려면 YAML에 on: webhook을 선언해야 해요.
Run
이름으로 Agent와 Workflow를 지정해 호출하는 실행 요청이에요.
호출할 때마다 Job 하나가 생성되고, params 값은 워크플로우 스텝의 환경변수로 전달돼요.
| Job 상태 | 의미 |
|---|---|
queued | 실행 대기 중 |
running | 실행 중 |
success | 성공적으로 종료 |
failed | 실패로 종료 |
timeout | 제한 시간 초과로 종료 |
rejected | 실행 요청 거절 |
canceled | 취소됨 |
Run 요청은 비동기로 접수하거나 wait: true로 결과까지 기다릴 수 있어요.
비동기 요청의 Job 상태는 응답의 consoleUrl에서 확인하고, API 토큰으로 상태를 조회하는 별도 엔드포인트는 없어요.
Release
Release는 Android 기기에 전달할 앱 아티팩트의 배포 버전이에요.
Agent SDK는 파일의 체크섬과 앱에 포함된 공개키를 사용해 서명을 확인하고, 실제 설치 시점은 앱이 결정해요.
API Token
API 토큰은 외부 시스템이 Deplite API를 호출할 때 사용하는 자격이에요.
토큰은 발급 시 평문으로 한 번만 표시되므로, 안전한 저장소에 보관해주세요.
| 스코프 | 권한 |
|---|---|
agent | 지정한 Agent에서 호출 허용된 Workflow 실행 |
workflow | 지정한 Agent와 Workflow만 실행 |
storage | managed 스토리지 파일 API에 지정한 read·write·delete 권한으로 접근 |
조직 전체의 실행 권한을 가진 토큰은 없어요.
종단 예시: 배포 호출
아래 흐름은 워크플로우를 선언하고, 토큰을 발급한 뒤 이름으로 한 번 실행하는 예예요.
- Agent의 워크플로우 YAML에서 외부 호출과 허용할 ref를 선언해요.
name: deploy
on:
webhook:
refs: [main, "release/*"]
steps:
- name: deploy
run: ./deploy.shon: 선언이 없으면 외부 호출은 허용되지 않아요.
refs를 생략하거나 빈 목록으로 두면 모든 ref가 허용돼요.
-
조직 owner가 콘솔에서 해당 Agent 또는 Workflow 권한의 API 토큰을 발급하고, 표시된 평문을 호출 환경에 보관해요.
-
호출 시스템에서 이름 기반 Run 요청을 보내요.
curl --fail-with-body -sS -X POST \
"https://api.deplite.io/v1/run/prod-server/deploy" \
-H "Authorization: Bearer ${DEPLITE_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"ref":"main","wait":true}'wait: true이면 Job 결과가 응답에 포함돼요.
콘솔에서 호출을 잠그거나 허용 ref를 더 좁힐 수 있으며, 실제 허용 ref는 YAML과 콘솔 설정을 모두 만족해야 해요.
요청과 실행 흐름은 다음과 같아요.