Docker Registry V2의 모든 이미지 나열

1. Docker Registry V2에서 전체 이미지 목록 얻기
2. 모든 리포지토리 및 이미지 나열
3. 리포지토리의 모든 태그 나열
4. 자격 증명으로 API 쿼리

몇 번의 반복을 통해 Docker Registry는 버전 1에서 버전 2로 업그레이드되었습니다. 특히 새로운 것은 공식 문서 웹사이트에 포함되거나 적절하게 문서화되어야 하는 일부 명령입니다.

한 가지 예는 Docker 레지스트리에서 이미지 목록을 가져오는 것입니다.

이 기사에서는 Docker Registry V2에서 이미지 목록을 가져오는 방법에 대해 설명합니다.

Docker Registry V2에서 전체 이미지 목록 얻기

시작하기 전에 아래 명령을 실행하여 DockerHub에서 최신 버전의 Docker Registry를 가져옵니다.

docker pull distribution/registry:master

Docker Registry 버전 1에서는 http://myregistry:5000/v1/search?의 기본 URL에 대한 API GET 호출을 수행하여 모든 이미지 목록을 가져올 수 있습니다. 설명서에 암시되어 있지는 않지만 업데이트된 다른 기본 URL에 GET 요청을 호출하여 유사한 접근 방식을 수행할 수도 있습니다.

모든 리포지토리 및 이미지 나열

Docker가 Docker 레지스트리를 버전 2로 업데이트하면 모든 API 기본 URL도 업데이트됩니다. 이제 v1 기본 URL을 호출하는 대신 아래 URL을 사용할 수 있습니다.

curl -X GET https://myregistry:5000/v2/_catalog

기본 결과에는 100개의 이미지 레코드만 표시되지만 더 표시해야 하는 경우 쿼리 매개변수를 추가하여 결과에 페이지를 매길 수 있습니다.

curl -X GET https://myregistry:5000/v2/_catalog?n=<count>

리포지토리의 모든 태그 나열

리포지토리의 모든 태그를 나열해야 하는 경우 아래에서 다른 엔드포인트를 사용할 수 있습니다.

curl -X GET https://myregistry:5000/v2/<name>/tags/list

name 값을 태그를 쿼리하려는 리포지토리의 이름으로 바꿀 수 있습니다.

자격 증명으로 API 쿼리

레지스트리에 인증이 필요한 경우 curl 명령에 -u 플래그를 추가하여 자격 증명을 지정해야 합니다.

curl -X GET -u <username>:<password> https://myregistry:5000/v2/_catalog
curl -X GET -u <username>:<password> https://myregistry:5000/v2/<name>/tags/list

레지스트리가 자격 증명 대신 자체 서명된 인증서를 사용하는 경우 -k 및 --insecure 플래그를 추가하여 안전하지 않은 요청을 할 수 있습니다. 그러나 이것은 보안 위험으로 간주되므로 위험을 감수하고 사용하십시오.

Docker Registry v2 API는 더 많은 요청을 수용하는 더 많은 엔드포인트를 제공합니다. 이 링크에서 전체 끝점을 찾을 수 있습니다.