Instalar gsutil

Importante: gsutil no es la CLI recomendada para Cloud Storage. Usa los comandos gcloud storage en Google Cloud CLI.

En esta página se describe la instalación y configuración de gsutil, una herramienta que te permite acceder a Cloud Storage desde la línea de comandos mediante HTTPS.

Al instalar gsutil, obtendrá acceso inmediato a los datos públicos, lo que le permitirá leer y escribir según los permisos que tenga. Para interactuar con los datos protegidos que se han compartido contigo, debes autenticarte en el servicio Cloud Storage. Si habilitas la facturación, podrás crear y gestionar tus propios contenedores.

Requisitos del sistema

• La herramienta gsutil se ejecuta en Linux/Unix, Mac OS y Windows (XP o versiones posteriores).

• Las versiones 5.35 o posteriores de gsutil requieren Python 3.9 a 3.13, que puedes obtener mediante tu gestor de versiones de Python o instalando una versión adecuada.

Nota: La versión 5.35 de gsutil ya no es compatible con Python 3.8. Para asegurar la compatibilidad con futuras versiones de gsutil, actualiza tu entorno de Python a una versión compatible (3.9 o posterior).

A continuación, se explica cómo gestionar las versiones de Python:

Linux

Requisitos previos: instala un gestor de versiones de Python (pyenv) e instala una versión de Python adecuada.

1. Establece la versión global de Python:
   • Para definir Python 3.13 como la versión global, sigue estos pasos:

     pyenv global 3.13

   • También puedes definir la versión de Python localmente para una carpeta de proyecto específica:

     pyenv local 3.13

2. Confirma que se está usando la versión correcta de Python:

   python --version

   Deberías ver lo siguiente:

   Python 3.13

macOS

Método 1: Usar Homebrew (brew)

Requisitos previos: instala Homebrew e instala una versión de Python adecuada a través de Homebrew.

1. Establece una versión específica de Python como predeterminada:
   • Añada la versión que quiera a su archivo $PATH. Por ejemplo, para usar Python 3.13:

     export PATH="/usr/local/opt/python@3.13/bin:$PATH"

   • Para que este cambio sea permanente, añade la ruta al archivo de configuración de tu shell (~/.bash_profile, ~/.zshrc o ~/.bashrc).
2. Confirma que se está usando la versión correcta de Python:

   python --version

   Deberías ver lo siguiente:

   Python 3.13

Método 2: Usar pyenv

Requisitos previos: instala el gestor de versiones de Python (pyenv) e instala una versión de Python adecuada a través de pyenv.

1. Define la versión global de Python:
   • Para definir la versión de Python de forma global (para todas las terminales), sigue estos pasos:

     pyenv global 3.13

   • También puedes definir la versión de Python localmente para una carpeta de proyecto específica:

     pyenv local 3.13

2. Confirma que se está usando la versión correcta de Python:

   python --version

   Deberías ver lo siguiente:

   Python 3.13

Windows

Requisitos previos: instala el gestor de versiones de Python (pyenv-win) e instala una versión de Python adecuada a través de pyenv.

1. Establece la versión global de Python:
   • Para definir Python 3.13 como la versión global, sigue estos pasos:

     pyenv global 3.13

   • También puedes definir la versión de Python localmente para una carpeta de proyecto específica:

     pyenv local 3.13

2. Confirma que se está usando la versión correcta de Python:

   python --version

   Deberías ver lo siguiente:

   Python 3.13

• Si tienes previsto usar objetos compuestos, debes instalar crcmod compilado. En Windows, solo está disponible para Python de 32 bits. Para obtener más información sobre crcmod, instala gsutil y consulta el tema de ayuda con el comando gsutil help crc32c.

Advertencia: En algunas distribuciones de Linux, hay preinstalada otra herramienta llamada gsutil, de GrandStream BudgeTone. Si ejecutas este comando en lugar de gsutil de Cloud Storage, es probable que se muestre un mensaje de error similar a "Choose one of -b, -d, -e, or -r to do something". Si esto ocurre, puedes mover la versión de Cloud Storage de gsutil al principio de la variable de entorno PATH o especificar la ruta completa al ejecutar gsutil de Cloud Storage (por ejemplo, /home/users/joan/gsutil/gsutil ls).

Instalar gsutil

Nota: Si ya has instalado la CLI de Google Cloud, gsutil ya está incluido. Además, la CLI de Google Cloud, incluido gsutil, se instala de forma predeterminada en varias imágenes de Google Compute Engine. Consulta los detalles del SO para ver una lista completa.

El método de instalación y actualización oficialmente admitido para gsutil es como parte de Google Cloud CLI.

Antes de empezar

Para instalar gsutil, te recomendamos que lo instales como parte de la CLI de Google Cloud. Si decides instalar gsutil directamente, usa Python 3.9 a 3.13 para evitar problemas de compatibilidad.

Instalar gsutil como parte de Google Cloud CLI

Sigue las instrucciones correspondientes a tu sistema operativo para instalar gsutil como parte de la CLI de Google Cloud:

Linux

1. Confirma que tienes una versión compatible de Python. Google Cloud CLI requiere Python 3.9 a 3.13. Ten en cuenta que el paquete de Linux x86_64 incluye un intérprete de Python empaquetado que se usará de forma predeterminada. Para obtener información sobre cómo elegir y configurar tu intérprete de Python, consulta gcloud topic startup.
2. Descarga una de las siguientes opciones:
   Nota: Para determinar tu plataforma Linux, ejecuta uname -a en la línea de comandos.

   Plataforma	Nombre del paquete	Tamaño	Suma de comprobación SHA256
   Linux de 64 bits (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	150,2 MB	8ba7e746ca05f225e5a73952bbc03f4086a5f65fd94f3717df6f75f212587159
   Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	56,8 MB	b16b40076503a2c07d0d60b67e126e39a02114029bcabdf4cf9eee96d8e5c55f
   Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	56,8 MB	3d5a46d0ce90845a87ca2c73930fc73b779744fd4b94b64c2c5e19c5c5aa67c7

   Para descargar el archivo Linux, ejecuta el siguiente comando:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   Consulta la tabla de arriba y sustituye google-cloud-cli-linux-x86_64.tar.gz por el nombre del paquete *.tar.gz que corresponda a tu configuración.

3. Para extraer el contenido del archivo en tu sistema de archivos (preferiblemente en tu directorio principal), ejecuta el siguiente comando:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Opcional: Para sustituir una instalación, elimina el directorio google-cloud-sdk y, a continuación, extrae el archivo en la misma ubicación.
4. (Opcional) Añade gcloud CLI a tu PATH. También puedes habilitar la opción de completar comandos para tu shell y la recogida de estadísticas de uso. Ejecuta la secuencia de comandos de instalación (desde la raíz de la carpeta que extrajo en el último paso) con el siguiente comando:

   ./google-cloud-sdk/install.sh

   También se puede hacer de forma no interactiva (por ejemplo, mediante una secuencia de comandos) y proporcionando preferencias como marcas. Para ver las marcas disponibles, ejecuta el siguiente comando:

   ./google-cloud-sdk/install.sh --help

   • Para enviar estadísticas de uso anónimas y ayudar a mejorar gcloud CLI, responde Y cuando se te pida.
   • Para añadir gcloud CLI a tu PATH y habilitar la función de autocompletar comandos, responde Y cuando se te pida.
5. Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.
6. Para inicializar gcloud CLI, ejecuta gcloud init:

./google-cloud-sdk/bin/gcloud init

7. Opcional: Instala componentes adicionales con el gestor de componentes.

Debian/Ubuntu

Nota: En función de tu configuración, puedes elegir otros métodos de instalación:

• Si quieres que gcloud se actualice automáticamente a la versión más reciente y utilizas una versión moderna de Ubuntu que usa Snap Package Manager, puedes instalar la CLI de Google Cloud como un paquete snap.
• Si usas una instancia en Compute Engine, la CLI de gcloud se instala de forma predeterminada en varias imágenes de SO. Consulta la lista completa de sistemas operativos.

Contenido del paquete

La CLI de gcloud está disponible en formato de paquete para instalarla en sistemas Debian y Ubuntu. Este paquete solo contiene los comandos gcloud, gcloud alpha, gcloud beta, gsutil y bq. No incluye kubectl ni las extensiones de App Engine necesarias para desplegar una aplicación mediante comandos gcloud. Si quieres usar estos componentes, debes instalarlos por separado.

Antes de empezar

Antes de instalar la CLI de gcloud, comprueba que tu sistema operativo cumpla los siguientes requisitos:

• Se trata de una versión de Ubuntu que no ha llegado al fin de su ciclo de vida o de una versión estable de Debian que no ha llegado al fin de su ciclo de vida.
• Ha actualizado recientemente sus paquetes:

  sudo apt-get update

• Tiene apt-transport-https y curl instalados:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Instalación

1. Importa la Google Cloud clave pública.

   • En distribuciones más recientes (Debian 9 o Ubuntu 18.04 y versiones posteriores), ejecuta el siguiente comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • En distribuciones anteriores, ejecuta el siguiente comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • Si el comando apt-key de tu distribución no admite el argumento --keyring, ejecuta el siguiente comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • Si no puedes obtener las últimas actualizaciones debido a que una clave ha caducado, obtén el archivo de clave apt-get.gpg más reciente.

2. Añade el URI de distribución de gcloud CLI como fuente de paquetes.
   • En distribuciones más recientes (Debian 9 o Ubuntu 18.04, o versiones posteriores), ejecuta el siguiente comando:

     echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • En las distribuciones anteriores que no admiten la opción signed-by, ejecuta el siguiente comando:

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Nota: Asegúrate de que no haya entradas duplicadas del repositorio cloud-sdk en /etc/apt/sources.list.d/google-cloud-sdk.list.
3. Actualiza e instala gcloud CLI:

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Para ver más opciones de apt-get, como inhabilitar las peticiones o las pruebas, consulta las páginas del manual de apt-get.

   Nota sobre Docker: Si vas a instalar la CLI de gcloud en una imagen de Docker, usa un solo paso RUN:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   En el caso de las imágenes base antiguas que no admiten el comando gpg --dearmor:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

4. (Opcional) Instala cualquiera de los siguientes componentes adicionales:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Por ejemplo, el componente google-cloud-cli-app-engine-java se puede instalar de la siguiente manera:

   sudo apt-get install google-cloud-cli-app-engine-java

5. Ejecuta gcloud init para empezar:

   gcloud init

Revertir a versiones anteriores de gcloud CLI

Para volver a una versión específica de la CLI de gcloud, donde VERSION tiene el formato 123.0.0, ejecuta el siguiente comando:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Las diez versiones más recientes están siempre disponibles en el repositorio.

NOTA: En las versiones anteriores a la 371.0.0, el nombre del paquete es google-cloud-sdk.

Red Hat/Fedora/CentOS

Nota: Si usas una instancia en Compute Engine, la CLI de Google Cloud se instala de forma predeterminada en varias imágenes de SO. Consulta la lista completa de sistemas operativos.

Contenido del paquete

La CLI de gcloud está disponible en formato de paquete para instalarse en sistemas Red Hat Enterprise Linux 7, 8 y 9; Fedora 41 y 42; y CentOS 7 y 8. Este paquete solo contiene los comandos gcloud, gcloud alpha, gcloud beta, gsutil y bq. No incluye kubectl ni las extensiones de App Engine necesarias para desplegar una aplicación con comandos de gcloud, que se pueden instalar por separado, como se describe más adelante en esta sección.

Instalación

1. Actualiza DNF con la información del repositorio de gcloud CLI. El siguiente comando de ejemplo es para una instalación compatible con Red Hat Enterprise Linux 9, pero asegúrate de actualizar los ajustes según sea necesario para tu configuración:

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM

2. Instala libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Instala gcloud CLI:

   sudo dnf install google-cloud-cli

Nota: Si no has migrado a dnf en tu sistema, puedes ejecutar estos comandos con yum.

También puedes usar las opciones dnf/yum, como inhabilitar las peticiones o las pruebas de funcionamiento, con los comandos proporcionados.

4. (Opcional) Instala cualquiera de los siguientes componentes adicionales:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Por ejemplo, el componente google-cloud-cli-app-engine-java se puede instalar de la siguiente manera:

   sudo dnf install google-cloud-cli-app-engine-java

5. Ejecuta gcloud init para empezar:

   gcloud init

Revertir a versiones anteriores de gcloud CLI

Si quieres volver a una versión específica de la CLI de gcloud, donde VERSION tiene el formato 123.0.0, ejecuta el siguiente comando: sudo dnf downgrade google-cloud-cli-VERSION Las diez versiones más recientes siempre estarán disponibles en el repositorio. NOTA: En las versiones anteriores a la 371.0.0, el nombre del paquete es google-cloud-sdk.

macOS

1. Confirma que tienes una versión compatible de Python:
   • Para comprobar tu versión actual de Python, ejecuta python3 -V o python -V. Las versiones compatibles son de Python 3.9 a 3.13.
   • La secuencia de comandos de instalación principal ofrece instalar Python 3.12 de CPython.
     • Para instalar Python, se necesitan las herramientas de línea de comandos de Xcode.
     • Para comprobar que las herramientas de línea de comandos de Xcode estén instaladas, ejecuta el comando xcode-select -p.
     • Si las herramientas de línea de comandos de Xcode no están instaladas, instálalas ejecutando el comando sudo xcode-select --install.
   • De lo contrario, para instalar una versión compatible de Python, visita la página de versiones de Python para macOS en Python.org.
   • Si tienes varios intérpretes de Python instalados en tu máquina, define la variable de entorno CLOUDSDK_PYTHON en tu shell para que apunte a la ruta del intérprete que prefieras.
   • Para obtener más información sobre cómo elegir y configurar tu intérprete de Python, consulta gcloud topic startup.
2. Descarga una de las siguientes opciones:
   Nota: Para determinar el nombre del hardware de tu máquina, ejecuta uname -m desde una línea de comandos.

Plataforma	Paquete	Tamaño	Suma de comprobación SHA256
macOS de 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	56,9 MB	60bc5dff80c4fbe52551294d9e85063bad76e6c6e27029727998fe81f6f872dd
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,8 MB	553ef5ba5a642e9704d5c3e3f45129d52df798d72e23d75f8feaf9ddc11bc52b
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	55,4 MB	3eeabd775fb55adbf557deced14366a481e111b7f26754b627616d9fb457b234

3. Extrae el archivo en cualquier ubicación de tu sistema de archivos (preferiblemente en tu directorio principal). En macOS, puedes hacerlo abriendo el archivo .tar.gz descargado en la ubicación que prefieras. También puedes ejecutar el siguiente comando:

   tar -xf google-cloud-cli-darwin-arm.tar.gz

   Opcional: Para sustituir una instalación, elimina el directorio google-cloud-sdk y, a continuación, extrae el archivo en la misma ubicación.

4. Ejecuta la secuencia de comandos de instalación (desde la raíz de la carpeta que extrajiste en el último paso) con el siguiente comando:

   ./google-cloud-sdk/install.sh

   La secuencia de comandos te pedirá que instales Python 3.12 y determinados módulos recomendados.

   La instalación también se puede realizar de forma no interactiva (por ejemplo, mediante una secuencia de comandos) proporcionando preferencias como marcas. Para describir las marcas disponibles, ejecuta el siguiente comando:

   ./google-cloud-sdk/install.sh --help

   Para ejecutar la secuencia de comandos de instalación con el modo Lector de pantalla activado, sigue estos pasos:

   ./google-cloud-sdk/install.sh --screen-reader=true

   Opcional:
   • Para enviar estadísticas de uso anónimas y ayudar a mejorar gcloud CLI, responde Y cuando se te pida.
   • Para añadir gcloud CLI a tu PATH y habilitar la función de autocompletar comandos, responde Y cuando se te pida.
5. Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.
6. Para inicializar gcloud CLI, ejecuta gcloud init:

./google-cloud-sdk/bin/gcloud init

7. Opcional. Instala componentes adicionales con el gestor de componentes.

Windows

La CLI de Google Cloud funciona en Windows 8.1 y versiones posteriores, así como en Windows Server 2012 y versiones posteriores.

1. Descarga el instalador de Google Cloud CLI.

   También puedes abrir un terminal de PowerShell y ejecutar los siguientes comandos de PowerShell:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. Inícialo y sigue las instrucciones. El instalador está firmado por Google LLC.

   Si usas un lector de pantalla, marca la casilla Activar el modo de lector de pantalla. Esta opción configura gcloud para que use indicadores de estado en lugar de spinners Unicode, muestre el progreso como un porcentaje y acople las tablas. Para obtener más información, consulta la guía de funciones de accesibilidad.

3. Google Cloud CLI requiere Python. Las versiones compatibles son de Python 3.9 a 3.13. De forma predeterminada, la versión de Windows de Google Cloud CLI incluye Python 3. Para usar la CLI de Google Cloud, tu sistema operativo debe poder ejecutar una versión compatible de Python.

   El instalador instala todas las dependencias necesarias, incluida la versión de Python que se necesita. Aunque la CLI de Google Cloud instala y gestiona Python 3 de forma predeterminada, puedes usar una instalación de Python que ya tengas si es necesario. Para ello, desmarca la opción Instalar Python incluido. Consulta gcloud topic startup para obtener información sobre cómo usar una instalación de Python.

4. Una vez completada la instalación, el instalador te ofrece la opción de crear accesos directos en el menú Inicio y en el escritorio, iniciar el shell de la CLI de Google Cloud y configurar la CLI de gcloud. Asegúrate de dejar seleccionadas las opciones para iniciar el shell y configurar tu instalación. El instalador abre una ventana de terminal y ejecuta el comando gcloud init.

5. La instalación predeterminada no incluye las extensiones de App Engine necesarias para desplegar una aplicación mediante comandos gcloud. Estos componentes se pueden instalar con el gestor de componentes de gcloud CLI.

Consejos para solucionar problemas:

• Si la instalación no se realiza correctamente porque no se reconoce el comando find, asegúrate de que la variable de entorno PATH incluya la carpeta que contiene find. Por lo general, es C:\WINDOWS\system32;.
• Si has desinstalado gcloud CLI, debes reiniciar el sistema antes de volver a instalarla.
• Si no se puede descomprimir, ejecuta el instalador como administrador.

Como parte de la instalación de gsutil, debes definir la variable de entorno CLOUDSDK_PYTHON para usar la versión correcta de Python. Para obtener más información, consulta la gcloud startup topic.

Realiza las actualizaciones con el comando components update: gcloud components update.

Configurar credenciales para acceder a datos protegidos

Para acceder a datos protegidos o escribir en un contenedor protegido, debes configurar las credenciales (autenticarte). Por ejemplo, si otra persona ha creado una cuenta de Cloud Storage y ha subido datos a los que solo puedes acceder tú u otras personas concretas, debes configurar tus credenciales para el servicio Cloud Storage para poder acceder a esos datos.

Cuando se usa gsutil como parte de Google Cloud CLI, se usa OAuth2 para autenticar y autorizar el acceso a los recursos de Cloud Storage. Para establecer el acceso, ejecuta el comando gcloud init y sigue las instrucciones que se indican en la línea de comandos, que incluyen iniciar sesión en tu cuenta de usuario. Ten en cuenta que es probable que ya hayas realizado esta configuración si has seguido los pasos de instalación. Si ya has ejecutado gcloud init anteriormente, cuando vuelvas a ejecutar el comando, se te preguntará si quieres reinicializar la configuración o crear una nueva. Para obtener más información, consulta Inicializar Google Cloud CLI.

Eso es todo. Ya puedes acceder a los datos protegidos. Para ver una lista de comandos de gsutil, escribe gsutil en la petición de comandos.

Solución de problemas

Si intentas autenticar gsutil con el comando gcloud init, pero sigues sin poder acceder a los objetos o los contenedores esperados, es posible que tu sistema tenga instaladas tanto la versión antigua independiente de gsutil como la versión de gsutil incluida en la CLI de Google Cloud. Ejecuta el comando gsutil version -l y comprueba el valor de using cloud sdk. Si False, tu sistema está usando la versión independiente de gsutil cuando ejecutas comandos. Te recomendamos que elimines la versión independiente de gsutil de tu sistema. Sin embargo, también puedes autenticarte con gsutil config -a o gsutil config -e.

Autenticarse con HMAC

Aunque OAuth 2.0 es el método recomendado para autenticar gsutil, también puedes usar claves HMAC para tus credenciales. Para autenticarte con HMAC, usa el siguiente comando:

gsutil config -a

Al usar este comando, se te pedirá el ID de acceso y el secreto asociados a tu clave HMAC durante el proceso de autenticación.

Cuando te autentiques con claves HMAC, debes inhabilitar la transferencia de credenciales desde la CLI de Google Cloud con el siguiente comando: gcloud config set pass_credentials_to_gsutil false.

Habilitar mTLS

También puedes habilitar TLS mutuo (mTLS). Cuando mTLS está habilitado en tu dispositivo, este intenta conectarse al endpoint de solicitud mTLS de la API JSON. Antes de permitir la conexión, Cloud Storage verifica el certificado de tu dispositivo.

Nota: Esta función solo funciona cuando gsutil hace solicitudes a través de la API JSON de Cloud Storage.

La forma más sencilla de obtener un certificado es a través de la CLI de Google Cloud. Puedes definir uno manualmente en el archivo .boto. Para ello, define los siguientes valores en "Credentials":

1. use_client_certificate: una marca que controla si se debe usar mTLS o no.
2. cert_provider_command: un comando de shell que imprime un certificado en stdout para que lo lea gsutil.

Pruébalo

Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.

Probar Cloud Storage gratis