GitHub Actions
Deplite 공식 GitHub Actions 4종으로 워크플로우 실행, workflow YAML 검사, 파일 관리와 앱 릴리스를 구성할 수 있어요.
모든 액션은 @v0 버전을 사용해주세요.
첫 릴리스 버전은 v0.1.0이에요.
공식 액션
| 액션 | 역할 | 상세 |
|---|---|---|
Deplite/run-action@v0 | Agent와 workflow 이름으로 기기 워크플로우 실행 | Run Action |
Deplite/files-action@v0 | managed 스토리지 파일 업로드·다운로드·삭제 | Files Action |
Deplite/validate-action@v0 | pull request의 workflow YAML 검사와 파일 오류 표시 | Validate Action |
Deplite/release-action@v0 | 아티팩트 업로드와 앱 릴리스 생성·발행·회수 | Release Action |
필요한 토큰 권한
| 액션 | 필요한 권한 |
|---|---|
run-action | 실행할 Agent의 agent 권한 또는 특정 workflow의 workflow 권한 |
files-action | storage 권한에서 업로드는 write, 다운로드는 read, 삭제는 delete |
validate-action | Deplite API 토큰이 필요하지 않아요 |
release-action | 릴리스 create·publish·yank 권한과 스토리지 read·write 권한. 정리 대상 중복 파일을 자동 삭제하려면 delete 권한도 설정해주세요 |
콘솔에서 필요한 권한의 API 토큰을 발급하고 GitHub 저장소의 Settings → Secrets and variables → Actions에 secret으로 저장해주세요.
토큰은 발급 직후 한 번만 평문으로 표시돼요.
워크플로우 실행
run-action은 기본적으로 기기 워크플로우가 끝날 때까지 기다리고, 실행 상태가 성공이 아니면 해당 Actions step을 실패 처리해요.
아래 예제에서는 params에 workflow 입력값을 JSON 객체로 전달해요.
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: production-device
workflow: deploy
params: '{"version":"1.2.3"}'ref를 생략하면 현재 브랜치나 태그의 짧은 이름인 GITHUB_REF_NAME을 사용해요.
워크플로우 YAML의 on.webhook.refs 범위에 맞는 ref인지 확인해주세요.
직접 HTTP 요청을 구성하려면 워크플로우 실행 API를 참고해주세요.
관련 문서
최종 수정 일자: