GitHub Actions

Deplite는 공식 GitHub Action 두 가지를 제공해요.
워크플로우 YAML 안에서 트리거를 호출하거나 파일을 업·다운로드할 수 있어, CI/CD에 가장 빠르게 붙는 방법이에요.

공식 액션

액션	역할	상세
`Deplite/trigger-action@v1`	트리거 호출, 잡 완료 대기	Trigger Action
`Deplite/files-action@v1`	스토리지에 파일 업·다운·삭제	Files Action

시작 전 준비

대시보드 API 토큰에서 토큰을 발급한 뒤, GitHub repo의 Settings → Secrets and variables → Actions에 DEPLITE_API_TOKEN이라는 이름으로 저장해주세요.
토큰은 발급 직후 한 번만 평문이 표시돼요.

용도별로 스코프를 좁히는 게 좋아요.

트리거만 쏘는 잡 → trigger 스코프 토큰
파일도 다루는 잡 → trigger + storage 스코프 토큰

대시보드의 API 토큰 → 토큰 발급 모달에서 trigger / storage 스코프를 선택해 만들 수 있어요.

가장 짧은 예제


name: Deploy
on:
  push:
    branches: [main]
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: Deplite/trigger-action@v1
        with:
          api-token: ${{ secrets.DEPLITE_API_TOKEN }}
          trigger-id: ${{ vars.DEPLITE_TRIGGER_ID }}
          params: '{"ref":"${{ github.sha }}"}'
          wait: sync

wait: sync로 두면 잡 완료까지 대기하고, 0이 아닌 exit code로 끝나면 step도 실패해요.

인증 모드

GitHub Actions는 External 모드만 지원해요.
Embedded 모드(서명 기반)는 Agent 바이너리나 SDK Embedded 기능을 사용해주세요.

REST·SDK와 비교

	GitHub Actions	REST API	SDK
코드 작성	❌ (YAML만)	✅ HTTP 클라이언트 직접	✅ 라이브러리 호출
어디서 도는지	runner 위	어디서나	앱·서버·CI
Embedded 모드	❌	✅ 직접 구현	✅
학습 곡선	가장 낮음	중간	낮음