Instalar Google Cloud CLI

Antes de empezar

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance project.

Cuando termines las tareas que se describen en este documento, puedes evitar que se te siga facturando eliminando los recursos que hayas creado. Para obtener más información, consulta la sección Limpiar.

Instalar la versión 548.0.0 de la CLI de gcloud

Linux

1. Confirma que tienes una versión compatible de Python. Google Cloud CLI requiere Python 3.9 a 3.14. 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 la documentación de gcloud topic startup.
2. Descarga una de las siguientes opciones:

   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	202,9 MB	71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a
   Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	57,7 MB	001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3
   Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	57,8 MB	921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc

   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.

3. Para extraer el contenido del archivo en tu sistema de archivos, ejecuta el siguiente comando:

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

   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 has extraído:

   ./google-cloud-sdk/install.sh

   El script te pedirá que realices las siguientes acciones de configuración. Para aceptar, responde Y cuando se te solicite.
   • Añade gcloud CLI a tu PATH.
   • Habilita la finalización de comandos.
   • Acepta enviar estadísticas de uso anónimas para ayudar a mejorar gcloud CLI.
   También puedes realizar la instalación de forma no interactiva proporcionando marcas. Para ver las marcas disponibles, ejecuta el siguiente comando:

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

5. Opcional: Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.

macOS

1. Confirma que tienes una versión compatible de Python. Google Cloud CLI requiere Python 3.9 a 3.14.

   Para comprobar tu versión de Python, ejecuta python3 -V o python -V.

   La secuencia de comandos de instalación puede instalar Python por ti si es necesario. Para ello, necesitas las herramientas de línea de comandos de Xcode. Para instalarlos, ejecuta sudo xcode-select --install. También puedes instalar una versión compatible de Python desde python.org.

   Para obtener más información sobre cómo configurar tu intérprete de Python, sobre todo si tienes varias versiones instaladas, consulta la documentación de gcloud topic startup.

2. Descarga uno de los siguientes:

   Plataforma	Paquete	Tamaño	Suma de comprobación SHA256
   macOS de 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	57,9 MB	6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8
   macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,8 MB	36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339
   macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	56,3 MB	eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56

   También puedes descargar el archivo desde la línea de comandos. Sustituye FILE_NAME por el nombre del paquete de tu plataforma de la tabla anterior.

   curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME

3. Extrae el contenido del archivo en la ubicación que prefieras de tu sistema de archivos. Lo habitual es extraerlo al directorio principal.

   En macOS, puedes hacerlo abriendo el archivo .tar.gz descargado en la ubicación que prefieras. También puede ejecutar el siguiente comando desde la línea de comandos:

   tar -xf FILE_NAME

   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 has extraído:

   ./google-cloud-sdk/install.sh

   El script te pedirá que realices las siguientes acciones de configuración. Para aceptar, responde Y cuando se te solicite.
   • Instala Python 3.13 y los módulos recomendados si es necesario.
   • Añade la CLI de gcloud a tu PATH y habilita la función de autocompletar comandos.
   • Acepta enviar estadísticas de uso anónimas para ayudar a mejorar gcloud CLI.
   También puedes realizar la instalación de forma no interactiva proporcionando marcas. Para ver 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 habilitado, sigue estos pasos:

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

5. Opcional: Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.

Windows

La CLI de Google Cloud en Windows requiere Windows 8.1 o una versión posterior, o Windows Server 2012 o una versión posterior.

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://storage.s3nsapis.fr/cloud-sdk-release/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.
   • Google Cloud CLI requiere Python. Las versiones compatibles son de Python 3.9 a 3.14. 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.

3. 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, así como de iniciar el shell de Google Cloud CLI. Desmarca la opción para iniciar la shell. En los siguientes pasos, ejecutarás y configurarás la CLI de gcloud.

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 la descompresión falla, ejecuta el instalador como administrador.

Inicializar y autorizar la CLI de gcloud

Si estás detrás de un proxy o un cortafuegos, consulta la sección Configuración de proxy para habilitar el acceso a la red de la CLI de gcloud.

Después de instalar la CLI de gcloud, inicialízala para autorizar el acceso a Cloud de Confiance y configurar una configuración predeterminada. Para obtener más información, consulta gcloud init.

1. Ejecuta gcloud init para inicializar gcloud CLI:

   gcloud init
   

   De forma predeterminada, este comando abre un navegador web para autorizar el acceso. Para autorizar desde la línea de comandos, añade la marca --console-only. Para la autorización no interactiva, crea una cuenta de servicio con los ámbitos adecuados en la consola deCloud de Confiance y, a continuación, usa gcloud auth activate-service-account con su archivo de clave JSON.

2. Sigue las indicaciones para autorizar y configurar lo siguiente:

   • Cuando se te solicite que inicies sesión, acepta y, a continuación, inicia sesión en tu cuenta de Google en el navegador. Haz clic en Permitir para dar permiso de acceso a los recursos.

   • En la lista de proyectos en los que tienes permisos de propietario, editor o lector, selecciona uno. Si solo tienes un proyecto, gcloud init lo selecciona automáticamente.

     Si tienes más de 200 proyectos, se te pedirá que introduzcas un ID de proyecto, que crees un proyecto o que muestres una lista de proyectos. Si decides crear un proyecto, también debes habilitar la facturación en él.

   • Si tienes habilitada la API Compute Engine, selecciona una zona de Compute Engine predeterminada.

3. Opcional: Para mejorar la experiencia con el lector de pantalla, habilita la propiedad accessibility/screen_reader con el siguiente comando:

   gcloud config set accessibility/screen_reader true
   

   Para obtener más información, consulta la guía sobre cómo habilitar las funciones de accesibilidad.

Ejecutar comandos principales

Ejecuta comandos básicos para ver información sobre tu instalación de gcloud CLI:

1. Lista las cuentas cuyas credenciales se almacenan en el sistema local:

   gcloud auth list
   

   La CLI de gcloud muestra una lista de cuentas con credenciales:

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   

2. Lista las propiedades de tu configuración activa de gcloud CLI:

   gcloud config list
   

   La CLI de gcloud muestra la lista de propiedades:

   [core]
   account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   disable_usage_reporting = False
   project = my-project
   

3. Consulta información sobre los gcloudcomandos y otros temas:

   gcloud help
   

   Por ejemplo, para ver la ayuda de gcloud compute instances create, haz lo siguiente:

   gcloud help compute instances create
   

   La CLI de gcloud muestra un tema de ayuda que contiene una descripción del comando, una lista de marcas y argumentos del comando, y ejemplos de cómo usar el comando.

Opcional: Instalar componentes adicionales

Para instalar componentes adicionales, como los emuladores de App Engine, kubectl o los comandos de gcloud CLI en la versión alfa o beta, consulta Gestión de componentes de gcloud CLI.

Limpieza

Para evitar que se apliquen cargos en tu cuenta de Cloud de Confiance por los recursos utilizados en esta página, sigue estos pasos.

Siguientes pasos

• Consulta la guía de la CLI de gcloud para obtener una descripción general de la CLI de gcloud, incluida una breve introducción a los conceptos clave, las convenciones de comandos y consejos útiles.
• Consulta la guía de referencia de la CLI de gcloud para ver páginas detalladas sobre cada comando de la CLI de gcloud, incluidas descripciones, marcas y ejemplos, que puedes usar para realizar diversas tareas en Cloud de Confiance.
• Consulta la hoja de referencia de gcloud CLI para ver una lista de los comandos y conceptos clave que se usan con frecuencia.