Nombres de repositorios e imágenes

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

Repositorios Docker

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

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY

Donde:

  • LOCATION es la ubicación regional del repositorio.
  • PROJECT es el ID del proyecto de tu consola Trusted Cloud .
  • REPOSITORY es el nombre del repositorio.

Por ejemplo, supongamos que tienes una imagen con las siguientes características:

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

El repositorio se especifica de la siguiente manera:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo

Nombres de imágenes de contenedor

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

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE

o

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE:TAG

o

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

donde:

  • LOCATION es la ubicación regional del repositorio.
  • PROJECT es el ID del proyecto de tu consola Trusted Cloud .
  • 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 quieres extraer.
  • IMAGE-DIGEST es el valor de hash sha256 del contenido de la imagen. En la Trusted Cloud consola, haz clic en la imagen específica para ver sus metadatos. El resumen se indica como Resumen de la imagen. Si no especifica una etiqueta o un resumen, Artifact Registry buscará la imagen con la etiqueta predeterminada latest. Consulta las versiones de imágenes de contenedor para obtener información sobre las versiones.

Por ejemplo, supongamos que tienes una imagen con las siguientes características:

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

Esta versión de la imagen etiquetada con staging se especifica de la siguiente manera:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test:staging

Versiones de imágenes de contenedor

Un repositorio 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 el digest o la etiqueta de la imagen.

Resumen
Un resumen de imagen es un hash generado automáticamente del índice de la imagen o del manifiesto de la imagen. Cada digestión de imagen es un identificador único de una versión de imagen y no se puede cambiar. El digest es el valor de hash sha256 del contenido de la imagen.
Etiqueta

Una etiqueta de imagen es una etiqueta y, a menudo, una cadena legible por humanos, como v1.1 o development. Una etiqueta solo puede apuntar a una versión de una imagen. En Artifact Registry, puede configurar un repositorio de Docker para permitir etiquetas de imagen mutables o para aplicar etiquetas de imagen inmutables.

  • Mutable: una etiqueta apunta a una sola versión de una imagen, pero el digest específico al que hace referencia puede cambiar.

    Una práctica habitual es etiquetar las imágenes con un identificador de versión, como v1.1 en tiempo de compilación. Cuando la compilación envía varias versiones de la imagen al registro con la misma etiqueta v1.1, la etiqueta hace referencia a la síntesis de la última versión enviada al registro. Aunque las etiquetas de imagen mutables ofrecen una forma cómoda de etiquetar versiones, un agente malintencionado también puede manipularlas para asociar una etiqueta a una versión maliciosa de una imagen.

  • Immutable en el repositorio, una etiqueta siempre apunta al mismo digest de imagen. Si un repositorio de Artifact Registry está configurado para usar etiquetas de imagen inmutables, no se permiten las siguientes acciones:

    • Eliminar una imagen etiquetada. Se sigue permitiendo eliminar imágenes sin etiquetar.
    • Quita una etiqueta de una imagen.
    • Envía una imagen con una etiqueta que ya esté en uso en otra versión de la imagen del repositorio.

Por ejemplo, supongamos que tienes una imagen con las siguientes características:

  • Ubicación del repositorio: u-france-east1
  • 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 la etiqueta, añade :staging al nombre de la imagen:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test:staging

Para identificarla con el resumen, añade @ al nombre de la imagen, seguido del resumen:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

En la consola, en la pantalla Imágenes, la columna Etiquetas muestra 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 Etiquetar imágenes para obtener más información sobre el etiquetado.

Nombres de repositorios como URLs

Para acceder a un repositorio o a un artefacto de un repositorio en la consola de Trusted Cloud , añade https:// al principio de su nombre completo.

Por ejemplo, para ver el repositorio u-france-east1-maven.s3nsregistry.fr/my-project/my-repo, usa la siguiente URL:

https://u-france-east1-maven.s3nsregistry.fr/my-project/my-repo

Para ver la imagen u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image, usa la siguiente URL:

https://u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image

Cualquier usuario autenticado que tenga permiso para acceder al repositorio puede usar estos enlaces.