Listar todas las imágenes en Docker Registry V2

1. Obtenga una lista completa de imágenes en Docker Registry V2
2. Listar todos los repositorios e imágenes
3. Listar todas las etiquetas de un repositorio
4. Consultar una API con credenciales

Algunas iteraciones atrás, Docker Registry se actualizó de la versión 1 a la versión 2. Particularmente nuevos, algunos comandos deben incluirse o documentarse adecuadamente en su sitio web de documentación oficial.

Un ejemplo es obtener la lista de imágenes en el Registro de Docker.

Este artículo discutirá cómo obtener la lista de imágenes en Docker Registry V2.

Obtenga una lista completa de imágenes en Docker Registry V2

Antes de comenzar, obtenga la última versión de Docker Registry en DockerHub ejecutando el siguiente comando.

docker pull distribution/registry:master

En Docker Registry versión 1, podemos obtener una lista de todas las imágenes realizando una llamada API GET a la URL base de http://myregistry:5000/v1/search?. Aunque no está implícito en la documentación, también podemos realizar un enfoque similar llamando a una solicitud GET a una URL base diferente y actualizada.

Listar todos los repositorios e imágenes

Cuando Docker actualizó Docker Registry a la versión 2, también actualizaron todas sus URL base de API. Así que ahora, en lugar de llamar a la URL base v1, podemos usar la siguiente URL.

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

El resultado predeterminado solo muestra cien (100) registros de imagen, pero si necesita mostrar más, puede paginar el resultado agregando un parámetro de consulta.

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

Listar todas las etiquetas de un repositorio

Si necesitamos enumerar todas las etiquetas de un repositorio, podemos usar un punto final diferente a continuación.

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

Podemos reemplazar el valor de nombre con el nombre del repositorio desde el que queremos consultar las etiquetas.

Consultar una API con credenciales

Si el registro necesita autenticación, debemos especificar nuestras credenciales en el comando curl agregando un indicador -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

Si nuestro registro utiliza un certificado autofirmado en lugar de credenciales, podemos realizar una solicitud insegura agregando las banderas -k y --insecure. Sin embargo, esto se considera un riesgo de seguridad, así que utilícelo bajo su propio riesgo.

La API de Docker Registry v2 ofrece más puntos finales que atienden a más solicitudes. Podemos encontrar los endpoints completos en este enlace.