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
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
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, selecciona el repositorio.
Haz clic en el nombre del paquete.
Para ver los archivos descargables de todas las versiones del paquete, haz clic en la pestaña Files.
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 comandogcloud artifacts files list
y copia el valor deFILE
.
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
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 comandogcloud artifacts files list
y copia el valor deFILE
. Debe convertirse al formato codificado como URL para este comando; por ejemplo,path/to/file.jar
se debe ingresar comopath%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ía comenzar la descarga de inmediato.¿Qué sigue?
- Cómo ver y enumerar repositorios
- Repositorios de etiquetas
- Repositorios de etiquetas
- Cómo borrar repositorios