Files Action
Deplite/files-action@v0은 GitHub Actions에서 Deplite managed 스토리지의 파일을 업로드·다운로드·삭제하는 공식 액션이에요.
하나의 액션이 mode 입력으로 세 동작을 선택해요.
선택한 모드에 필요한 managed 스토리지 권한을 가진 API 토큰을 전달해주세요.
업로드에는 write, 다운로드에는 read, 삭제에는 delete 권한이 필요해요.
Inputs
| 이름 | 필수 | 모드 | 기본값 | 설명 |
|---|---|---|---|---|
api-token | ✅ | 공통 | — | managed 스토리지 권한이 있는 Deplite Bearer 토큰 |
mode | ✅ | 공통 | — | upload, download, delete 중 하나 |
path | upload일 때 필요 | upload | — | 업로드할 로컬 파일 경로 |
filename | upload | basename(path) | 저장될 파일명 오버라이드 | |
content-type | upload | — | MIME 타입 | |
cleanup-rule | upload일 때 필요 | upload | — | ttl 또는 persistent |
ttl-seconds | upload | — | cleanup-rule=ttl일 때 TTL 초 | |
binding-id | upload | — | managed 스토리지 binding UUID. 토큰이 여러 binding을 허용하면 지정해주세요 | |
file-id | ✅ | download, delete | — | 파일 UUID |
dest | ✅ | download | — | 다운로드 결과를 저장할 로컬 경로 |
base-url | 공통 | https://api.deplite.io/v1 | API 베이스 URL 오버라이드 |
Outputs
| 이름 | 모드 | 설명 |
|---|---|---|
file-id | upload | 새로 생성된 파일의 UUID |
size | upload, download | 파일 크기(byte) |
status | upload | 파일 상태 |
동작 상세
Upload — 3단계 (presign + PUT + complete)
1. POST BASE_URL/storage/files/presign-upload
body: { filename, cleanupRule, contentType?, ttlSeconds?, bindingId? }
→ { fileId, uploadUrl, uploadHeaders?, expiresInSeconds? }
2. PUT UPLOAD_URL
headers: uploadHeaders, Content-Type
body: file stream
3. POST BASE_URL/storage/files/FILE_ID/complete
→ FileMeta { id, size, status, ... }첫 번째와 세 번째 요청은 Bearer 인증, 두 번째 요청은 presigned URL로 전송해요.
업로드가 끝나면 outputs.file-id를 다른 step에 넘기거나 POST /v1/run/{agentName}/{workflowName}의 params로 전달할 수 있어요.
이름 기반 워크플로우 호출 예제는 워크플로우 실행 API를 참고해주세요.
Download — 2단계
1. GET BASE_URL/storage/files/FILE_ID/download-url
→ { downloadUrl, expiresInSeconds }
2. GET DOWNLOAD_URL
→ 응답 본문을 DEST에 스트림으로 저장dest의 상위 디렉토리는 자동 생성돼요.
다운로드한 바이트 수가 outputs.size로 들어와요.
Delete — 1단계
DELETE BASE_URL/storage/files/FILE_ID
→ 204 No Content 또는 다른 2xx404 응답은 step 실패로 처리돼요.
파일이 없을 때 계속 진행하려면 continue-on-error: true를 설정해주세요.
오류 처리
비-2xx 응답은 HTTP status와 body를 포함해 오류로 처리하고 step이 실패해요.
네트워크 오류와 디스크 오류도 step 실패로 처리돼요.
자동 재시도는 없어요.
일시적 5xx에 대응하려면 step 단위 retry를 구성해주세요.
Bearer 인증 외 환경변수 사용 없음
Files Action은 GITHUB_* 환경변수를 사용하지 않아요.
모든 동작은 inputs와 토큰으로 결정돼요.
managed 스토리지 binding이 여러 개일 때
토큰이 여러 managed 스토리지 binding에 권한을 가진 경우, 업로드할 binding을 binding-id로 지정할 수 있어요.
- uses: Deplite/files-action@v0
with:
api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }}
mode: upload
binding-id: ${{ vars.STAGING_STORAGE_BINDING_ID }}
path: ./build/app.apk
cleanup-rule: persistent토큰이 단일 binding만 허용한다면 해당 binding이 자동 선택돼요.
모드별 최소 예제
Upload
- uses: Deplite/files-action@v0
id: upload
with:
api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }}
mode: upload
path: ./build/app.apk
content-type: application/vnd.android.package-archive
cleanup-rule: ttl
ttl-seconds: 86400
- run: echo "fileId=${{ steps.upload.outputs.file-id }}"Download
- uses: Deplite/files-action@v0
with:
api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }}
mode: download
file-id: ${{ vars.BUILD_FILE_ID }}
dest: ./downloaded.binDelete
- uses: Deplite/files-action@v0
with:
api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }}
mode: delete
file-id: ${{ vars.BUILD_FILE_ID }}