Descargar archivos

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

La descarga de archivos puede ser útil cuando quieres trasladarlos a tu entorno sin herramientas de formato específico. Ten en cuenta que 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. Cualquier archivo dentro de un paquete de Java, como los archivos jar y pom.xml, se disponibles para descargar.

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

Roles obligatorios

A fin de obtener los permisos que necesitas para descargar archivos almacenados en un repositorio, solicita 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 a proyectos, carpetas y organizaciones.

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

Enumerar archivos

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

Console

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

    Abrir 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, haz clic en la pestaña Files.

  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, luego, en la pestaña Archivos.

gcloud

Para todos los siguientes comandos, puedes establecer una cantidad máxima de archivos que se mostrarán Para ello, agrega 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 mostrar una lista de 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: el regional o multirregional location 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 encuentra la imagen. cuando se almacena.
  • PACKAGE: Es el nombre del paquete.
  • VERSION: Es la versión del paquete.

En el caso de los repositorios de Docker, puedes enumerar los archivos para una etiqueta de imagen de contenedor específica Para ello, agrega la marca --tag al comando.

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

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, realiza los siguientes reemplazos:

  • PROJECT: tu Google Cloud ID del proyecto: Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • LOCATION: Es la región o multirregional. location del repositorio.
  • REPOSITORY: Es el nombre del repositorio. en la 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. Puede encontrar esta Para ello, 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: tu Google Cloud ID del proyecto: 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 tu comando fallará.
  • FILE: Es el nombre de archivo codificado en URL. Puedes Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE. Debe ser se convertirá 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:

La descarga debería comenzar de inmediato.

¿Qué sigue?