Administra metadatos de artefactos

En esta página, se describe cómo administrar los metadatos relacionados con un artefacto almacenado en Artifact Registry como un adjunto.

Los adjuntos son archivos que almacenan metadatos sobre un artefacto relacionado almacenado en Artifact Registry. Para obtener información sobre cómo crear un adjunto, consulta Almacena metadatos de artefactos en adjuntos.

Antes de comenzar

Opcional: Configura valores predeterminados para los comandos de Google Cloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para administrar archivos adjuntos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el repositorio:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Mostrar lista de archivos adjuntos

Un artefacto en Artifact Registry puede tener cualquier cantidad de archivos adjuntos que hagan referencia a él. Puedes enumerar los archivos adjuntos con la Google Cloud consola, gcloud CLI o, solo para imágenes de contenedores en formato Docker, Oras.

Consola (solo Docker)

  1. En la Google Cloud consola, abre la página Repositorios.

    Abrir la página repositorios

  2. Haz clic en el nombre del repositorio para ver las imágenes que contiene.

  3. Para ver las versiones de una imagen, haz clic en su nombre.

  4. Haz clic en la versión de imagen adecuada.

  5. Para ver los archivos adjuntos de esa versión, haz clic en la pestaña Archivos adjuntos.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • TARGET: Es el nombre de la versión completamente calificado. Solo para imágenes de Docker, también puedes usar el URI de Artifact Registry del artefacto al que hace referencia el adjunto. En el URI, puedes usar el resumen o, para las imágenes de Docker, la etiqueta, por ejemplo, us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments list \
    --target=TARGET

Windows (PowerShell)

gcloud artifacts attachments list `
    --target=TARGET

Windows (cmd.exe)

gcloud artifacts attachments list ^
    --target=TARGET
 Para obtener más información, consulta el comando gcloud artifacts attachments list.

Oras (solo para Docker)

Antes de ejecutar el comando, realiza el siguiente reemplazo:

  • IMAGE_URI: Es el URI de la imagen de destino a la que hacen referencia los adjuntos enumerados.
oras discover --distribution-spec v1.1-referrers-api IMAGE_URI

En el siguiente ejemplo, se enumeran los archivos adjuntos de una imagen de contenedor, my-image, identificada por su URI y etiqueta:

oras discover --distribution-spec v1.1-referrers-api \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1

Aquí:

  • v1.1-referrers-api es la API de URL de referencia que se usa. Para obtener más información, consulta los detalles en la especificación de distribución.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 es el URI que incluye la etiqueta de la versión de la imagen de contenedor para la que se enumerarán los archivos adjuntos.

Para obtener una guía completa y más ejemplos, consulta la documentación de oras discover.

Describe los archivos adjuntos

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • ATTACHMENT: Es el nombre completamente calificado del adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del adjunto y usa las marcas --location y --repository.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments describe ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments describe ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments describe ATTACHMENT
 Para obtener más información, consulta el comando gcloud artifacts attachments describe.

Descargar archivos adjuntos

Puedes descargar archivos adjuntos con gcloud CLI o, solo para imágenes de contenedores en formato Docker, con Oras.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • ATTACHMENT: Es el nombre completamente calificado del adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del adjunto y usa las marcas --location y --repository.
  • DESTINATION: Es la ruta de acceso en tu sistema de archivos local para descargar el archivo adjunto.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments download ATTACHMENT \
    --destination=DESTINATION

Windows (PowerShell)

gcloud artifacts attachments download ATTACHMENT `
    --destination=DESTINATION

Windows (cmd.exe)

gcloud artifacts attachments download ATTACHMENT ^
    --destination=DESTINATION
 Para los archivos adjuntos en repositorios con formato de Docker, como alternativa a proporcionar ATTACHMENT, puedes proporcionar la marca --oci-version-name seguida del nombre completo de la versión del archivo adjunto o el URI de Artifact Registry. Puedes usar el resumen o la etiqueta, por ejemplo, projects/my-project/locations/us-west1/repositories/my-repo/packages/my-package/versions/sha256:abc123.

Para obtener más información, consulta el comando gcloud artifacts attachments download.

Oras (solo para Docker)

Antes de ejecutar el comando, realiza los siguientes reemplazos:

  • DESTINATION: Es el directorio de destino del adjunto.

  • ATTACHMENT_URI: Es el URI del adjunto que se descargará. Es el URI del contenedor de imágenes al que hace referencia el adjunto, seguido del SHA único del adjunto.

oras pull -o DESTINATION ATTACHMENT_URI

En el siguiente ejemplo, se descarga un adjunto identificado por su URI y resumen:

oras pull -o . us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx

Aquí:

  • -o . asigna el nombre del directorio actual como destino de descarga.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx es el URI de la imagen, incluido el resumen del adjunto que se descargará.

Para obtener una guía completa y más ejemplos, consulta la documentación de oras pull.

Borra archivos adjuntos

Puedes borrar archivos adjuntos directamente con la consola de Google Cloud o gcloud CLI. Puedes borrar archivos adjuntos de forma indirecta si borras el artefacto al que hacen referencia.

Borrar archivos adjuntos directamente

Puedes borrar archivos adjuntos directamente con una de las siguientes opciones:

Consola (solo Docker)

  1. En la Google Cloud consola, abre la página Repositorios.

    Abrir la página repositorios

  2. Haz clic en el nombre del repositorio para ver las imágenes que contiene.

  3. Haz clic en el nombre de la imagen para ver las versiones correspondientes.

  4. Haz clic en la versión de la imagen para la que quieres ver los archivos adjuntos.

  5. Haz clic en la pestaña Archivos adjuntos para ver los archivos adjuntos de esa versión.

  6. Haz clic en el resumen del adjunto que deseas borrar.

  7. Haz clic en BORRAR.

  8. En el diálogo de confirmación, haz clic en BORRAR.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • ATTACHMENT: Es el nombre completamente calificado del adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del adjunto y usa las marcas --location y --repository.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments delete ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments delete ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments delete ATTACHMENT
 Para obtener más información, consulta el comando gcloud artifacts attachments delete.

Borra archivos adjuntos de forma indirecta

Si se borra un artefacto, también se borran todos los archivos adjuntos que tengan el nombre de la versión del artefacto borrado como su target. Esto se aplica tanto a la eliminación manual de artefactos como a las eliminaciones causadas por las políticas de limpieza.

¿Qué sigue?