Instalar gcloud CLI

En esta página se incluyen instrucciones para elegir y mantener una instalación de la CLI de Google Cloud. La CLI de Google Cloud incluye las herramientas de línea de comandos gcloud, gsutil y bq. Para ver una lista de las funciones de gcloud CLI, consulta Todas las funciones.

Para acceder a las APIs de Google Cloud con un lenguaje de programación compatible, puedes descargar las bibliotecas de cliente de Cloud.

Instrucciones de instalación

Estas instrucciones son para instalar Google Cloud CLI. Para obtener información sobre cómo instalar componentes adicionales, como los comandos de la CLI de gcloud en la versión alfa o beta, consulta Gestionar componentes de la CLI de gcloud.

Nota: Si estás detrás de un proxy o un cortafuegos, consulta la página de configuración del proxy para obtener más información sobre la instalación.

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, y 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.

Otras opciones de instalación

En función de tus necesidades de desarrollo, puedes usar un método alternativo para instalar la CLI de gcloud en lugar de la instalación recomendada:

• ¿Usas gcloud CLI con secuencias de comandos o integración o implementación continuas? Descarga un archivo versionado para instalar de forma no interactiva una versión específica de gcloud CLI.
• ¿Necesitas ejecutar la CLI de gcloud como una imagen de Docker? Usa la imagen Docker de la CLI de gcloud para obtener la versión más reciente (o una versión específica) de la CLI de gcloud.
• ¿Usas Ubuntu y prefieres las actualizaciones automáticas? Usa un paquete snap para instalar gcloud CLI.
• Para las instalaciones interactivas en Windows y macOS, así como para todos los demás casos prácticos, ejecuta el instalador interactivo para instalar la versión más reciente de la CLI de gcloud.

Gestionar una instalación

Una vez que hayas instalado gcloud CLI, podrás usar comandos del grupo de comandos gcloud components para gestionar tu instalación. Esto incluye ver los componentes instalados, añadir y quitar componentes, y actualizar a una versión nueva o volver a una versión específica de la CLI de gcloud.

Por ejemplo, puedes usar el siguiente comando para actualizar tu versión de gcloud CLI:

gcloud components update

Nota: Si has usado apt-get o yum para instalar gcloud CLI, debes usar apt-get o yum para actualizar o quitar componentes, no gcloud components.

Versiones anteriores de la CLI de gcloud

Si necesitas otra versión de gcloud CLI, instala la versión actual siguiendo las instrucciones que aparecen más arriba en esta página y, a continuación, inicia sesión. Una vez que hayas iniciado sesión, podrás descargar versiones anteriores. Para ver las versiones ordenadas por fecha, habilita Ordenar y filtrar y haz clic en la columna Creado.

Versiones de Python compatibles

Google Cloud CLI requiere Python 3.9 a 3.13. Para obtener información sobre cómo elegir y configurar tu intérprete de Python, consulta gcloud topic startup.

Pruébalo

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

Empezar gratis