Skip to Content
가이드빠른 시작

빠른 시작

이 문서는 가장 빠른 경로로 Deplite를 체험할 수 있도록 만들었어요.
모든 단계를 끝내면 첫 워크플로우 한 개가 webhook으로 실행될 거예요.

이 가이드는 Linux/macOS 환경을 기준으로 해요. Windows는 WSL2 사용을 권장해요.

사전 준비

  • Deplite 계정 (https://app.deplite.io  에서 가입)
  • 조직 1개와 owner 권한
  • 워크플로우를 돌릴 서버 (테스트용이면 로컬 머신도 충분해요)

1. Enrollment Token 발급

대시보드에서 좌측 메뉴의 Agents → Enroll new agent를 클릭하면 1회용 토큰이 발급돼요.

# API로 직접 발급할 수도 있어요
curl -X POST https://app.deplite.io/api/orgs/<orgId>/agents/enroll-tokens \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"label": "my-first-agent"}'

응답으로 받은 token 값(enr_...)을 잠시 후 환경변수로 사용할 거예요.

2. Agent 바이너리 다운로드

# Linux x86_64
curl -L -o deplite-agent \
  https://releases.deplite.io/agent/latest/linux-amd64/deplite-agent
chmod +x deplite-agent

3. 디렉토리 준비

Agent는 다음 세 폴더를 사용해요.

mkdir -p ./workflows ./creds ./logs

4. 첫 워크플로우 작성

./workflows/hello.yaml 파일을 만들어 주세요.

name: hello
timeout-minutes: 5
steps:
  - name: Greet
    run: |
      echo "안녕하세요, Deplite!"
      echo "현재 시각: $(date)"

5. Agent 실행

export DEPLITE_TOKEN="enr_..."   # 1단계에서 받은 값
./deplite-agent

성공하면 다음과 같이 보여요.

[INFO] Enrolled as agent <uuid>
[INFO] Connected to https://api.deplite.io (SSE)
[INFO] Scanned 1 workflow: hello

이제 Agent는 ./creds/ 폴더에 자기만의 ED25519 키쌍을 저장하고, SSE로 서버 명령을 기다려요.

6. Trigger 만들기

대시보드에서 Triggers → New webhook → workflow로 hello를 선택하세요.
생성 후 API Tokens에서 trigger scope 토큰도 함께 발급하세요.

7. 실행해 보기

curl -X POST https://api.deplite.io/triggers/<triggerId>/run \
  -H "Authorization: Bearer tk_..." \
  -H "Content-Type: application/json" \
  -d '{"ref": "manual"}'

응답으로 jobId가 오면 성공이에요.
대시보드의 Jobs 화면에서 실행 결과와 로그를 바로 확인할 수 있어요.

다음으로

최종 수정 일자:
Deplite 소개Agent 설치