Descargar archivos

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

Descargar archivos puede ser útil cuando deseas 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 individuales 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 para descargarse 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 los comandos de gcloud CLI.

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 de Lector del registro de artefactos (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 crear una lista de archivos en 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 mostrarán si agregas 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 especificados, ejecuta el siguiente comando:

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

Para obtener una lista de 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, 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: Es el Google Cloud ID de tu 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 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, realiza los siguientes reemplazos:

• PROJECT: Es el Google Cloud ID de tu 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 completo del archivo. 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

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: Es el Google Cloud ID de tu 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. Para encontrar este valor, ejecuta el comando gcloud artifacts files list y copia el valor de FILE. Debe convertirse 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ía comenzar la descarga de inmediato.

¿Qué sigue?

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