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 archivo adjunto.

Los archivos adjuntos son archivos que almacenan metadatos sobre un artefacto relacionado almacenado en Artifact Registry. Para obtener información sobre cómo crear un archivo adjunto, consulta Almacena metadatos de artefactos en archivos 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 los 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.

Cómo mostrar una lista de archivos adjuntos

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

Consola (solo Docker)

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

    Abrir la página repositorios

  2. Haz clic en el nombre del repositorio para ver las imágenes en él.

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

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

  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: 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 se hace referencia en el archivo 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 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 muestran los archivos adjuntos de una imagen de contenedor, my-image, que se identifica 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 Referrer que se usa. Para obtener más información, consulta los detalles en las especificaciones 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 del contenedor para la que se enumeran 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 archivo adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del archivo 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 la CLI de gcloud o, solo para imágenes de contenedores en formato Docker, 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 archivo adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del archivo adjunto y usa las marcas --location y --repository.
  • DESTINATION: Es la ruta de acceso en el sistema de archivos local a la que se 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 de formato 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 Docker)

Antes de ejecutar el comando, realiza los siguientes reemplazos:

  • DESTINATION: Es el directorio de destino del archivo adjunto.

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

oras pull -o DESTINATION ATTACHMENT_URI

En el siguiente ejemplo, se descarga un archivo 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 que incluye el resumen del archivo 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. Para borrar archivos adjuntos de forma indirecta, borra el artefacto al que hace referencia.

Borra archivos adjuntos directamente

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

Consola (solo Docker)

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

    Abrir la página repositorios

  2. Haz clic en el nombre del repositorio para ver las imágenes en él.

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

  4. Haz clic en la versión de la imagen de 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 archivo adjunto que quieres 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 archivo adjunto, como projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Como alternativa, proporciona solo el ID del archivo 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 con 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?