Descargar archivos

En esta página, se describe cómo descargar archivos individuales de los repositorios estándar y remotos de Artifact Registry. El repositorio puede tener cualquier formato de artefactos.

La descarga de archivos puede ser útil cuando quieres transferirlos a tu entorno local sin herramientas de formato específico. Ten en cuenta que debes autenticarte en Artifact Registry antes de descargar los archivos.

Archivos descargables

Puedes descargar cualquier archivo de datos o metadatos individual que se encuentre en tu repositorio. Por ejemplo, un repositorio de Maven almacenará paquetes de Java como artefactos. Cualquier archivo dentro de un paquete de Java, como los archivos JAR y los archivos pom.xml, está disponible de forma individual para su descarga.

No se recomienda usar esta función en artefactos que dependen en gran medida de las herramientas del cliente para operaciones de descarga, como las imágenes de Docker.

Antes de comenzar

Funciones obligatorias

Si quieres obtener los permisos que necesitas para descargar archivos almacenados en un repositorio, pídele a tu administrador que te otorgue el rol de IAM Lector de Artifact Registry (roles/artifactregistry.reader) en el repositorio. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Enumerar archivos

Puedes enumerar los archivos de un repositorio para ver cuáles están disponibles para descargar.

En todos los comandos siguientes, puedes configurar una cantidad máxima de archivos que se mostrarán si agregas la marca --limit al comando.

Para enumerar todos los archivos en el proyecto, el repositorio y la ubicación predeterminados cuando se configuran los valores predeterminados, haz lo siguiente:

gcloud artifacts files list

Para mostrar una lista de los archivos de un proyecto, un repositorio y una ubicación especificados, ejecuta el siguiente comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Para mostrar una lista de archivos para todas las versiones de un paquete específico:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Para mostrar una lista de los archivos de una versión específica de un paquete, haz lo siguiente:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Reemplaza los siguientes valores:

  • LOCATION: es la ubicación regional o multirregional del repositorio.
  • PROJECT: El ID del proyecto de Google Cloud. 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.
  • PACKAGE: Es el nombre del paquete.
  • VERSION: Es la versión del paquete.

En los repositorios de Docker, puedes enumerar los archivos para una etiqueta de imagen de contenedor específica si agregas la marca --tag al comando.

Para obtener más información, consulta la lista de archivos de artefactos de gcloud.

Descargar archivos

Para descargar archivos individuales de un repositorio, ejecuta el siguiente comando:

gcloud

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

  • PROJECT: Es el ID del proyecto de Google Cloud. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • LOCATION: Es la ubicación regional o multirregional del repositorio.
  • REPOSITORY: Es el nombre del repositorio en el que se almacena el artefacto.
  • DESTINATION: Es la ruta a la carpeta de destino en el sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
  • FILE: Es el nombre del archivo completo. Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud artifacts files download \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY \
    --destination=DESTINATION \
    FILE

Windows (PowerShell)

gcloud artifacts files download `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY `
    --destination=DESTINATION `
    FILE

Windows (cmd.exe)

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE
Deberías ver que la descarga comienza de inmediato.

API

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

  • PROJECT: Es el ID del proyecto de Google Cloud. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • LOCATION: Es la ubicación regional o multirregional del repositorio.
  • REPOSITORY: Es el nombre del repositorio en el que se almacena el artefacto.
  • DESTINATION: Es la ruta a la carpeta de destino en el sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
  • FILE: Es el nombre de archivo con codificación URL. Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE. Debe convertirse al formato de codificación URL para este comando. Por ejemplo, path/to/file.jar debería ingresarse como path%2Fto%2Ffile.jar.

Método HTTP y URL: 

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Para enviar tu solicitud, expande una de estas opciones:

Deberías ver que la descarga comienza de inmediato.

¿Qué sigue?