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 ser de cualquier formato de artefacto.

Descargar archivos puede ser útil cuando quieras obtener archivos en tu entorno local sin herramientas específicas de formato. Ten en cuenta que debes autenticarte en Artifact Registry antes de descargar archivos.

Archivos descargables

Puedes descargar cualquier archivo de datos o metadatos que se encuentre en tu repositorio. Por ejemplo, un repositorio de Maven almacenará paquetes de Java como artefactos. Todos los archivos de un paquete de Java, como los archivos JAR y los archivos pom.xml, se pueden descargar de forma individual.

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

Antes de empezar

Roles obligatorios

Para obtener los permisos que necesitas para descargar archivos almacenados en un repositorio, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Lector de Artifact Registry (roles/artifactregistry.reader) en el repositorio. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Mostrar archivos

Puedes enumerar los archivos de un repositorio para ver qué se puede descargar.

consola

  1. Abre la página Repositorios en la consola de Google Cloud .

    Abre la página Repositorios.

  2. En la lista de repositorios, selecciona el repositorio.

  3. Haz clic en el nombre del paquete.

  4. Para ver los archivos descargables de todas las versiones del paquete, haga clic en la pestaña Archivos.

  5. Para ver los archivos descargables de una versión específica de tu paquete, haz clic en el nombre de la versión y, a continuación, en la pestaña Archivos.

gcloud

En todos los comandos siguientes, puedes definir un número máximo de archivos que se devuelvan añadiendo la marca --limit al comando.

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

gcloud artifacts files list

Para enumerar los archivos de un proyecto, un repositorio y una ubicación específicos, ejecuta el siguiente comando:

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

Para enumerar los archivos de todas las versiones de un paquete específico, haz lo siguiente:

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

Para enumerar los archivos de una versión específica de un paquete, sigue estos pasos:

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

Sustituye los siguientes valores:

  • LOCATION: la ubicación regional o multirregional del repositorio.
  • PROJECT: tu Google Cloud ID de proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con ámbito de dominio.
  • REPOSITORY: el nombre del repositorio en el que se almacena la imagen.
  • PACKAGE: el nombre del paquete.
  • VERSION: la versión del paquete.

En los repositorios de Docker, puedes enumerar los archivos de una etiqueta de imagen de contenedor específica añadiendo la marca --tag al comando.

Para obtener más información, consulta gcloud artifacts files list.

Descargar archivos

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

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • PROJECT: su Google Cloud ID de proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con ámbito de dominio.
  • LOCATION: la ubicación regional o multirregional del repositorio.
  • REPOSITORY: el nombre del repositorio donde se almacena el artefacto.
  • DESTINATION: la ruta a la carpeta de destino en tu sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
  • FILE: el nombre de 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 cómo empieza la descarga inmediatamente.

API

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT: su Google Cloud ID de proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con ámbito de dominio.
  • LOCATION: la ubicación regional o multirregional del repositorio.
  • REPOSITORY: el nombre del repositorio donde se almacena el artefacto.
  • DESTINATION: la ruta a la carpeta de destino en tu sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
  • FILE: nombre de archivo codificado como URL. Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE. Para usar este comando, debe convertirse al formato de codificación URL. Por ejemplo, path/to/file.jar debe introducirse 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, despliega una de estas opciones:

La descarga debería empezar de inmediato.

Siguientes pasos