Descargar archivos

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

La descarga de archivos puede ser útil cuando deseas colocar archivos en tu entorno local sin herramientas de formato específico. Ten en cuenta que aún debes autenticarte en Artifact Registry antes de descargar 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. Todos los archivos dentro de un paquete de Java, como los archivos jar y pom.xml, están disponibles de forma individual para su descarga.

No se recomienda usar esta función para artefactos que dependen en gran medida de las herramientas del cliente para las 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 de 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 funciones personalizadas o, también, otras funciones predefinidas.

Enumerar archivos

Puedes enumerar los archivos de un repositorio a fin de ver los que están disponibles para descargar.

Para 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 en un proyecto, un repositorio y una ubicación especificados, ejecuta el comando:

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

Para enumerar los archivos de todas las versiones de un paquete específico, ejecuta el siguiente comando:

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

Para enumerar los archivos de una versión de paquete específica, 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ónregional o multirregionaldel 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.

Para 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 de acceso a la carpeta de destino en tu 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 de acceso a la carpeta de destino en tu sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
  • FILE: Es el nombre de archivo codificado en formato URL. Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE. Debe convertirse al formato con 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?