Skip to Content
가이드통합하기GitHub Actions

GitHub Actions로 통합

Deplite는 GitHub Actions 공식 액션 4종을 제공해요.
Run Action으로 기기 workflow를 실행하고, Validate Action으로 YAML을 검사하며, Files Action과 Release Action으로 파일과 앱 릴리스를 관리할 수 있어요.

1. 토큰과 이름 준비

콘솔에서 실행할 Agent의 agent 권한 또는 특정 workflow의 workflow 권한 토큰을 발급해주세요.
GitHub 저장소의 Settings → Secrets and variables → Actions에서 토큰을 DEPLITE_API_TOKEN secret으로 저장해주세요.
Agent 이름과 workflow 이름은 Actions Variables에 DEPLITE_AGENT_NAME, DEPLITE_WORKFLOW_NAME으로 저장해주세요.
Files Action에는 모드에 필요한 storage 권한을, Release Action에는 릴리스 create·publish·yank와 스토리지 read·write 권한을 가진 토큰을 준비해주세요.
Release Action이 정리 대상 중복 파일을 자동 삭제하도록 하려면 스토리지 delete 권한도 추가해주세요.

2. Pull request에서 workflow YAML 검사

validate-action은 Deplite API 토큰 없이 저장소의 workflow YAML을 검사하고 오류를 PR 파일에 표시해요.

name: Validate Deplite workflows on: pull_request: paths: - 'workflows/**/*.yml' - 'workflows/**/*.yaml' jobs: validate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - uses: Deplite/validate-action@v0 with: path: workflows

Linux 또는 macOS runner를 사용해주세요.

3. workflow 실행

Agent에 둔 Deplite workflow YAML에서 on.webhook으로 외부 이름 기반 호출을 허용해주세요.
아래 선언은 main ref에서 호출할 수 있도록 열어요.

name: deploy on: webhook: refs: [main] steps: - name: deploy run: ./scripts/deploy.sh

GitHub Actions에서는 Deplite/run-action@v0의 agent와 workflow 입력으로 대상 이름을, params로 workflow 입력값을 전달해주세요.
ref를 생략하면 현재 브랜치·태그의 짧은 이름인 GITHUB_REF_NAME을 사용해요.
기본 설정은 기기 workflow가 끝날 때까지 기다리고, 성공하지 않은 결과는 Actions step을 실패 처리해요.

name: Deploy on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - uses: Deplite/run-action@v0 with: api-token: ${{ secrets.DEPLITE_API_TOKEN }} agent: ${{ vars.DEPLITE_AGENT_NAME }} workflow: ${{ vars.DEPLITE_WORKFLOW_NAME }} params: '{"version":"1.2.3"}'

4. 파일과 함께 실행

Files Action에는 upload 모드에 필요한 storage: write 권한을 전달하고, 업로드한 file ID를 Run Action의 params에 넣어주세요.

- uses: Deplite/files-action@v0 id: upload with: api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }} mode: upload path: ./build/app.apk cleanup-rule: ttl ttl-seconds: 3600 - uses: Deplite/run-action@v0 with: api-token: ${{ secrets.DEPLITE_API_TOKEN }} agent: ${{ vars.DEPLITE_AGENT_NAME }} workflow: ${{ vars.DEPLITE_WORKFLOW_NAME }} params: '{"apkFileId":"${{ steps.upload.outputs.file-id }}"}'

5. 앱 릴리스 생성과 발행

Release Action은 아티팩트를 업로드하고 앱 릴리스를 만들거나 발행해요.
아래 예제는 기본 publish 모드로 앱 릴리스를 발행해요.

- uses: Deplite/release-action@v0 id: release with: api-token: ${{ secrets.DEPLITE_RELEASE_TOKEN }} app: ${{ vars.DEPLITE_APP_SLUG }} path: ./build/app.apk version: 1.2.3 channel: stable

전체 입력·출력과 오류 안내는 GitHub Actions 문서에서 확인해주세요.
워크플로우 실행 API의 요청·응답 필드는 워크플로우 실행 API를 참고해주세요.

관련 문서

최종 수정 일자: