registry

앱 내장 OCI 컨테이너 레지스트리. /api/v1/registry/tokens 로 docker 로그인용 PAT 를 관리하고, 레지스트리 자체는 호스트 루트 /v2 에 있습니다. /v2/ 진입점만 여기에 문서화되어 있으며, 하위 경로는 OCI Distribution Spec 을 그대로 따릅니다.

이미지를 넣는 경로는 두 가지입니다. docker push 가 가능하면 /v2 를 쓰고, docker save 로 뜬 tar 파일만 있으면 /api/v1/registry/imports 로 올립니다. 반입한 이미지는 push 한 것과 저장 형태가 같아 같은 주소로 pull 됩니다.

GET /v2/#

GET/v2/

컨테이너 레지스트리 진입점

앱 내장 OCI 컨테이너 레지스트리(Docker Registry HTTP API V2)의 진입점.

응답

GET /api/v1/registry/tokens#

GET/api/v1/registry/tokens

컨테이너 레지스트리 토큰 목록

컨테이너 레지스트리 토큰 목록을 조회합니다(메타데이터만, 시크릿 제외).

필요 권한: VIEW

응답

POST /api/v1/registry/tokens#

POST/api/v1/registry/tokens

컨테이너 레지스트리 토큰 발급

호출자의 현재 테넌트로 범위가 지정된 컨테이너 레지스트리 토큰을 발급합니다.

요청 본문: application/json, TokenCreate

응답

POST /api/v1/registry/tokens/{token_id}:revoke#

POST/api/v1/registry/tokens/{token_id}:revoke

컨테이너 레지스트리 토큰 폐기

컨테이너 레지스트리 토큰을 폐기하여 즉시 액세스를 차단합니다.

필요 권한: VIEW

파라미터

응답

GET /api/v1/registry/repositories#

GET/api/v1/registry/repositories

컨테이너 이미지 리포지토리 목록

현재 테넌트의 컨테이너 리포지토리를 나열합니다.

필요 권한: VIEW

파라미터

응답

GET /api/v1/registry/repositories/{name}/tags#

GET/api/v1/registry/repositories/{name}/tags

리포지토리 태그 목록

리포지토리의 태그를 매니페스트 digest/크기와 함께 나열합니다.

필요 권한: VIEW

파라미터

응답

GET /api/v1/registry/repositories/{name}/manifests/{reference}#

GET/api/v1/registry/repositories/{name}/manifests/{reference}

이미지 매니페스트 상세

태그 또는 digest 로 이미지 매니페스트를 조회합니다.

필요 권한: VIEW

파라미터

응답

GET /api/v1/registry/imports#

GET/api/v1/registry/imports

이미지 반입 목록

현재 테넌트의 이미지 반입 이력을 최신순으로 조회합니다.

필요 권한: VIEW

파라미터

응답

POST /api/v1/registry/imports#

POST/api/v1/registry/imports

이미지 반입 세션 생성

docker save 로 만든 이미지 아카이브를 올릴 업로드 세션을 엽니다.

필요 권한: DEVELOP

요청 본문: application/json, ImportCreate

응답

PATCH /api/v1/registry/imports/{import_id}/chunks#

PATCH/api/v1/registry/imports/{import_id}/chunks

이미지 반입 청크 전송

아카이브의 한 청크를 이어붙입니다(application/octet-stream).

필요 권한: DEVELOP

파라미터

응답

POST /api/v1/registry/imports/{import_id}:start#

POST/api/v1/registry/imports/{import_id}:start

이미지 반입 시작

업로드를 마감하고 레지스트리 등록을 시작합니다.

필요 권한: DEVELOP

파라미터

응답

GET /api/v1/registry/imports/{import_id}#

GET/api/v1/registry/imports/{import_id}

이미지 반입 상세

반입 한 건의 상태와 진행률을 조회합니다(VIEW 권한).

파라미터

응답

DELETE /api/v1/registry/imports/{import_id}#

DELETE/api/v1/registry/imports/{import_id}

이미지 반입 기록 삭제

끝난 반입 기록을 삭제합니다(DEVELOP 권한).

파라미터

응답

POST /api/v1/registry/imports/{import_id}:cancel#

POST/api/v1/registry/imports/{import_id}:cancel

이미지 반입 취소

진행 중인 반입을 취소합니다.

필요 권한: DEVELOP

파라미터

응답