참조API
배포
deployments 묶음의 오퍼레이션 3 개입니다.
| 메서드 | 경로 | 하는 일 |
|---|---|---|
| GET | /v1/orgs/{orgSlug}/projects/{projectName}/deployments | 배포 이력 |
| POST | /v1/orgs/{orgSlug}/projects/{projectName}/deployments | 아티팩트 업로드 후 배포 |
| POST | /v1/orgs/{orgSlug}/projects/{projectName}/rollback | 이전 버전으로 되돌린다 |
GET /v1/orgs/{orgSlug}/projects/{projectName}/deployments
최신 버전이 먼저 온다. 아티팩트는 불변이고 삭제하지 않는다.
operationId listDeployments
| 응답 | 뜻 | 본문 |
|---|---|---|
| 200 | 배포 목록 | object |
| 403 | — | — |
| 404 | — | — |
POST /v1/orgs/{orgSlug}/projects/{projectName}/deployments
본문은 번들 tarball 그 자체다. 메타데이터를 따로 받지 않는 이유는 번들이 자기를 설명하기 때문이다 — 매니페스트가 번들 안에 있으므로 다이제스트 하나가 코드·자산·설정을 전부 덮는다. 별도 필드로 받으면 다이제스트가 덮지 않는 입력이 생긴다.
번들 레이아웃 (gzip 된 tar):
runlot.json 매니페스트 (필수) worker/ 워커 코드. 정적 사이트면 없어도 된다 assets/ 정적 자산. 없어도 된다
같은 다이제스트를 다시 올리면 새 version 이 생긴다 — 배포는 "이 코드를 올린다"가 아니라 "지금 이것을 서빙한다"는 사건이고, 롤백 이력이 읽히려면 그 사건이 각각 남아야 한다.
업로드가 성공하면 새 배포가 즉시 live 가 된다.
operationId createDeployment
본문 application/gzip · string
| 응답 | 뜻 | 본문 |
|---|---|---|
| 201 | 생성된 배포 | Deployment |
| 400 | — | — |
| 403 | — | — |
| 404 | — | — |
| 413 | 번들이 상한을 넘음 | Error |
POST /v1/orgs/{orgSlug}/projects/{projectName}/rollback
새 배포를 만들지 않고 project_live 를 옛 배포로 옮긴다. 아티팩트가
불변이므로 되돌린 결과는 그때 서빙하던 것과 정확히 같은 바이트다.
operationId rollback
본문 application/json · object
| 응답 | 뜻 | 본문 |
|---|---|---|
| 200 | 되돌린 배포 | Deployment |
| 403 | — | — |
| 404 | — | — |