조합 레시피
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.sh7. 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: workflows8. 앱 릴리스 생성과 발행
태그로 빌드한 파일을 앱 릴리스로 업로드하고 발행할 수 있어요.
토큰에는 릴리스 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