Skip to Content

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 중 하나
pathupload일 때 필요upload—업로드할 로컬 파일 경로
filenameuploadbasename(path)저장될 파일명 오버라이드
content-typeupload—MIME 타입
cleanup-ruleupload일 때 필요upload—ttl 또는 persistent
ttl-secondsupload—cleanup-rule=ttl일 때 TTL 초
binding-idupload—managed 스토리지 binding UUID. 토큰이 여러 binding을 허용하면 지정해주세요
file-id✅download, delete—파일 UUID
dest✅download—다운로드 결과를 저장할 로컬 경로
base-url공통https://api.deplite.io/v1 API 베이스 URL 오버라이드

Outputs

이름모드설명
file-idupload새로 생성된 파일의 UUID
sizeupload, download파일 크기(byte)
statusupload파일 상태

동작 상세

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 또는 다른 2xx

404 응답은 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.bin

Delete

- uses: Deplite/files-action@v0 with: api-token: ${{ secrets.DEPLITE_STORAGE_TOKEN }} mode: delete file-id: ${{ vars.BUILD_FILE_ID }}

관련 문서

최종 수정 일자: