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.

Descargar archivos puede ser útil cuando deseas transferirlos a tu entorno local sin herramientas específicas para el formato. Ten en cuenta que, antes de descargar archivos, debes autenticarte en Artifact Registry.

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 los archivos pom.xml, están disponibles para su descarga de forma individual.

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

• (Opcional) Establece valores predeterminados para gcloud CLI de gcloud.

Roles obligatorios

Para 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 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 para ver qué está disponible 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 Files.

gcloud

Para todos los siguientes comandos, puedes establecer una cantidad máxima de archivos que se devolverán agregando 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 enumerar los archivos en un proyecto, un repositorio y una ubicación especificados, 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 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ón regional o multirregional del repositorio.
• PROJECT: El Google Cloud ID del proyecto. 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 el caso de los repositorios de Docker, puedes enumerar los archivos de una etiqueta de imagen de contenedor específica agregando 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 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 completo. Puedes encontrar este valor ejecutando el comando gcloud artifacts files list y copiando el valor de FILE.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

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 el comando fallará.
• FILE: Es el nombre de archivo codificado en URL. Puedes encontrar este valor ejecutando el comando gcloud artifacts files list y copiando el valor de FILE. Se debe convertir al formato codificado como URL para este comando. Por ejemplo, path/to/file.jar se debe ingresar 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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

Deberías ver que la descarga comienza de inmediato.

¿Qué sigue?

• Cómo ver y enumerar repositorios
• Repositorios de etiquetas
• Repositorios de etiquetas
• Borrar repositorios