Es posible que parte o toda la información de esta página no se aplique a Trusted Cloud by S3NS. Para obtener más información, consulta las diferencias con Google Cloud.

Esta página se ha traducido con Cloud Translation API.

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.

Antes de seguir las instrucciones de esta guía, consulta el artículo Configurar la CLI de Google Cloud Trusted 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.

Linux

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.

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,3 MB	de44b49eac7d8b1f7371c9c6ecd91ea6c72ea5abae29486cbdb47947a7403279
Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	56,9 MB	22d9a460ff0443b03ecdc73b3fbb20ac39d85db63838ab8c77fbc544d30ff635
Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	56,9 MB	ccae88e39b0f3d5093b50395f5e6aaeab6d8f2b9edc23c4bfa10a4ec2a4ee384

Para descargar el archivo Linux, ejecuta el siguiente comando:

curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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.

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.
(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.
Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.
Para inicializar gcloud CLI, ejecuta gcloud init:

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

Opcional: Instala componentes adicionales con el gestor de componentes.

macOS

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.
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	57,0 MB	eb2348efb70fa63bf1eca56f8926ca0abc16f60e819810ae86f4638e121d493a
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,9 MB	0acc6fea1b73fc8633728dd5480215ec5db13f5489a6d7700829295e4c82a349
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	55,5 MB	b580b371989e8375c6c457510e5d659915c67e7920c052e94d27eaf502553210

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.
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.
Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.
Para inicializar gcloud CLI, ejecuta gcloud init:

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

Opcional. Instala componentes adicionales con el gestor de componentes.

Windows

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://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

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.
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.
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.
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.
¿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

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.