Nombres de repositorios y de imágenes

Artifact Registry usa una convención de asignación de nombres para identificar los repositorios y las imágenes cuando usas los comandos de gcloud, docker y la API para interactuar con los repositorios.

Repositorios de Docker

El nombre completo de un repositorio de Docker tiene el siguiente formato:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY

Donde:

  • LOCATION es la ubicación regional o multirregional del repositorio.

  • PROJECT es el ID de tu proyecto de Google Cloud Console. Si el ID de tu proyecto contiene dos puntos (:) y trabajas con un repositorio de Docker, consulta Proyectos con alcance de dominio.

  • REPOSITORY es el nombre del repositorio.

Por ejemplo, considera una imagen con las siguientes características:

  • Ubicación del repositorio: us
  • Formato del repositorio: docker
  • Nombre del repositorio: my-repo
  • ID del proyecto: my-project

El repositorio se especifica de la siguiente manera:

us-docker.pkg.dev/my-project/my-repo

Nombres de imágenes de contenedores

El nombre completo de una imagen de contenedor tiene uno de los siguientes formatos:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE

o

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE:TAG

o

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

Donde:

  • LOCATION es la ubicación regional o multirregional del repositorio.
  • PROJECT es el ID de tu proyecto de Google Cloud Console. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • REPOSITORY es el nombre del repositorio en el que se almacena la imagen.
  • IMAGE es el nombre de la imagen en el repositorio.
  • TAG es la etiqueta de la versión de la imagen que deseas extraer.
  • IMAGE-DIGEST es el valor de hash sha256 del contenido de la imagen. En Google Cloud Console, haz clic en la imagen específica para ver sus metadatos. El resumen se muestra como el resumen de la imagen.

    Si no especificas una etiqueta o un resumen, Artifact Registry busca la imagen con la etiqueta predeterminada latest. Consulta Versiones de la imagen de contenedor para obtener información sobre las versiones.

Por ejemplo, considera una imagen con las siguientes características:

  • Ubicación del repositorio: us
  • Nombre del repositorio: my-repo
  • ID del proyecto: my-project
  • Nombre de la imagen: test
  • Etiqueta: staging

Esta versión de la imagen etiquetada como etapa de pruebas se especifica de la siguiente manera:

us-docker.pkg.dev/my-project/my-repo/test:staging

Versiones de la imagen de contenedor

Un registro puede contener muchas imágenes de contenedor, y estas imágenes pueden tener diferentes versiones. Para identificar una versión específica de una imagen, puedes especificar la etiqueta o el resumen de la imagen. Las etiquetas son exclusivas de una imagen dentro de un registro. Los resúmenes se generan automáticamente, son únicos para una versión de una imagen y tienen la forma @[IMAGE_DIGEST], en la que [IMAGE_DIGEST] es el valor de hash sha256 del contenido de la imagen.

Por ejemplo, considera una imagen con las siguientes características:

  • Ubicación del repositorio: us
  • Nombre del repositorio: my-repo
  • ID del proyecto: my-project
  • Nombre de la imagen: test
  • Etiqueta: staging
  • Resumen: sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Para identificar la imagen con su etiqueta, usa lo siguiente:

us-docker.pkg.dev/my-project/my-repo/test:staging

Para identificarla con el resumen, usa lo siguiente:

us-docker.pkg.dev/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio a continuación.

En la consola, enImágenes pantalla, laEtiquetas enumera las etiquetas de la imagen. Haz clic en la versión de la imagen para ver los metadatos, incluido el resumen de la imagen.

Consulta Etiqueta imágenes para obtener más información sobre el etiquetado.

Proyectos con alcance de dominio

Si tu proyecto tiene permisos para tu dominio, el ID del proyecto incluye el nombre del dominio seguido de dos puntos (:). Debido a la forma en que Docker trata los dos puntos, debes reemplazar el carácter de dos puntos por una barra diagonal cuando especifiques el resumen de una imagen en Artifact Registry. Identifica las imágenes en estos tipos de proyectos con el siguiente formato:

LOCATION-docker.pkg.dev/DOMAIN/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

Por ejemplo, el proyecto con ID example.com:my-project podría tener la siguiente imagen:

us-docker.pkg.dev/example.com/my-project/my-repo/image-name