Skip to Content
문서GitHub Actions조합 레시피

조합 레시피

GitHub Actions에서 Deplite workflow를 실행하고 파일을 처리하는 조합 예제예요.
Run Action에는 대상 Agent의 agent 권한 또는 특정 workflow의 workflow 권한 토큰을 전달해주세요.
Files Action에는 모드에 맞는 managed 스토리지 read·write·delete 권한을 사용해주세요.

1. 빌드 산출물 업로드 후 배포

빌드한 APK를 managed 스토리지에 올린 뒤 파일 ID를 workflow params로 전달해요.

name: Build and Deploy on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: { node-version: 20 } - run: npm ci && npm run build:apk - 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 }} ref: ${{ github.ref_name }} params: '{"apkFileId":"${{ steps.upload.outputs.file-id }}"}'

워크플로우는 DEPLITE_PARAM_APKFILEID 환경변수로 파일 ID를 받아 Files API에서 파일을 사용할 수 있어요.
Files Action 토큰에는 업로드에 필요한 storage: write 권한을 설정해주세요.

2. PR에 배포 결과 코멘트

동기 실행 응답의 status와 consoleUrl을 PR 코멘트에 남기는 패턴이에요.

jobs: deploy-preview: if: github.event_name == 'pull_request' runs-on: ubuntu-latest permissions: pull-requests: write steps: - id: deploy name: Run Deplite workflow uses: Deplite/run-action@v0 with: api-token: ${{ secrets.DEPLITE_API_TOKEN }} agent: ${{ vars.DEPLITE_AGENT_NAME }} workflow: ${{ vars.DEPLITE_WORKFLOW_NAME }} params: '{"prNumber":"${{ github.event.pull_request.number }}"}' - uses: actions/github-script@v7 with: script: | const status = '${{ steps.deploy.outputs.status }}' const consoleUrl = '${{ steps.deploy.outputs.console-url }}' github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: 'Deplite workflow: ' + status + '\n' + consoleUrl, })

3. Matrix로 여러 Agent 배포

staging·canary·prod 환경마다 다른 Agent에 같은 workflow를 실행해요.
GitHub Actions Variables에 AGENT_STAGING, AGENT_CANARY, AGENT_PROD를 설정해주세요.

jobs: multi-deploy: runs-on: ubuntu-latest strategy: matrix: env: [staging, canary, prod] steps: - name: Run Deplite workflow uses: Deplite/run-action@v0 with: api-token: ${{ secrets.DEPLITE_API_TOKEN }} agent: ${{ vars[format('AGENT_{0}', matrix.env)] }} workflow: ${{ vars.DEPLOY_WORKFLOW_NAME }} params: '{"environment":"${{ matrix.env }}"}'

matrix 표현식은 현재 환경에 맞는 Agent 이름을 선택해요.

4. Reusable workflow

여러 저장소에서 같은 실행 패턴을 쓸 때 Agent 이름과 workflow 이름을 입력으로 전달할 수 있어요.

# .github/workflows/deplite-deploy.yml (호출되는 쪽) on: workflow_call: inputs: agent_name: { required: true, type: string } workflow_name: { required: true, type: string } ref: { required: false, type: string, default: main } secrets: deplite_token: { required: true } jobs: run-deplite: runs-on: ubuntu-latest steps: - name: Run Deplite workflow uses: Deplite/run-action@v0 with: api-token: ${{ secrets.deplite_token }} agent: ${{ inputs.agent_name }} workflow: ${{ inputs.workflow_name }} ref: ${{ inputs.ref }}
# 호출하는 쪽 jobs: call-deploy: uses: acme/devops/.github/workflows/deplite-deploy.yml@main with: agent_name: ${{ vars.STAGING_AGENT_NAME }} workflow_name: ${{ vars.DEPLOY_WORKFLOW_NAME }} ref: ${{ github.ref_name }} secrets: deplite_token: ${{ secrets.DEPLITE_API_TOKEN }}

5. 릴리즈 아티팩트 영구 보관

GitHub Actions에서 만든 정식 릴리즈 빌드는 cleanup-rule: persistent로 managed 스토리지에 보관할 수 있어요.

on: release: types: [published] jobs: upload-artifact: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: ./scripts/build-release.sh - uses: Deplite/files-action@v0 id: upload with: api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }} mode: upload path: ./dist/release.tar.gz filename: release-${{ github.event.release.tag_name }}.tar.gz cleanup-rule: persistent - name: Show uploaded file ID run: echo "Stored release file ID: ${{ steps.upload.outputs.file-id }}"

6. 다운로드 후 재가공

Actions에서 managed 스토리지 파일을 받아 다시 가공할 수 있어요.

- uses: Deplite/files-action@v0 with: api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }} mode: download file-id: ${{ vars.LATEST_BUILD_FILE_ID }} dest: ./input.tar.gz - run: | tar xzf ./input.tar.gz ./scripts/repackage.sh

7. PR에서 workflow YAML 검사

PR에서 workflow 디렉토리를 검사하고 오류를 파일에 표시할 수 있어요.
Deplite API 토큰은 필요하지 않아요.

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

8. 앱 릴리스 생성과 발행

태그로 빌드한 파일을 앱 릴리스로 업로드하고 발행할 수 있어요.
토큰에는 릴리스 create·publish·yank와 스토리지 read·write 권한이 필요해요.
참조되지 않는 중복 업로드 파일의 자동 정리에는 스토리지 delete 권한이 사용돼요.

name: Publish app release on: push: tags: ['v*'] jobs: release: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: ./scripts/build-release.sh - uses: Deplite/release-action@v0 with: api-token: ${{ secrets.DEPLITE_RELEASE_TOKEN }} app: ${{ vars.DEPLITE_APP_SLUG }} path: ./dist/release.apk version: ${{ github.ref_name }} channel: stable

관련 문서

최종 수정 일자: