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 Google Cloud CLI

En esta guía de inicio rápido se explica cómo instalar e inicializar la CLI de Google Cloud y cómo ejecutar algunos comandos básicos de la CLI de gcloud.

Antes de seguir las instrucciones de esta guía, consulta el artículo Configurar la CLI de Google Cloud Trusted Cloud.

Antes de empezar

In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Trusted Cloud project.

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

Instalar la versión más reciente de gcloud CLI (540.0.0)

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.

Opcional: Instalar las bibliotecas de cliente de Cloud más recientes

Puedes descargar las bibliotecas de cliente de Cloud para los lenguajes admitidos.

Inicializar la CLI de gcloud

Usa el comando gcloud init para realizar varias tareas de configuración comunes de la CLI de gcloud. Esto incluye autorizar la CLI de gcloud para acceder a Trusted Cloud con las credenciales de tu cuenta de usuario y configurar la configuración predeterminada.

Inicializa gcloud CLI:
```
gcloud init
```
Nota: Para evitar que el comando abra un navegador web, usa gcloud init --console-only. Para autorizar sin un navegador web y de forma no interactiva, crea una cuenta de servicio con los ámbitos adecuados mediante la consolaTrusted Cloud y usa gcloud auth activate-service-account con el archivo de clave JSON correspondiente.
Acepta la opción para iniciar sesión con tu cuenta de usuario de Google:
```
To continue, you must log in. Would you like to log in (Y/n)? Y
```
En tu navegador, inicia sesión en tu cuenta de usuario de Google cuando se te solicite y haz clic en Permitir para conceder permiso de acceso a los recursos de Trusted Cloud .
En el símbolo del sistema, selecciona un Trusted Cloud proyecto de la lista de proyectos en los que tengas permisos de Propietario, Editor o Lector:
```
Pick cloud project to use:
 [1] [my-project-1]
 [2] [my-project-2]
 ...
 Please enter your numeric choice:
```
Si solo tienes un proyecto, gcloud init lo selecciona automáticamente.

Si tienes acceso a 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.
```
This account has a lot of projects! Listing them all can take a while.
 [1] Enter a project ID
 [2] Create a new project
 [3] List projects
Please enter your numeric choice:
```
Nota: Si decides crear un proyecto, también tendrás que habilitar la facturación en él para usar los Trusted Cloud by S3NS servicios.

Si tienes habilitada la API de Compute Engine, gcloud init te permite elegir una zona de Compute Engine predeterminada:

Which compute zone would you like to use as project default?
 [1] [asia-east1-a]
 [2] [asia-east1-b]
 ...
 [14] Do not use default zone
 Please enter your numeric choice:

gcloud init confirma que has completado los pasos de configuración correctamente:

Run `gcloud help config` to learn how to change individual settings

This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
Run `gcloud topic configurations` to learn more.

Some things to try next:

* Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
* Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
* Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.

(Opcional) Para mejorar la experiencia con el lector de pantalla, habilita la propiedad accessibility/screen_reader:
```
gcloud config set accessibility/screen_reader true
```
Para obtener más información sobre las funciones de accesibilidad que incluye la CLI de gcloud, 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:

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
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

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 = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

Consulta información sobre la instalación de la herramienta de línea de comandos gcloud y la configuración activa:
```
gcloud info
```
La CLI de gcloud muestra un resumen de la información sobre tu instalación. Esto incluye información sobre tu sistema, los componentes instalados, la cuenta de usuario activa y el proyecto actual, así como las propiedades de la configuración activa.
Consulta información sobre los gcloudcomandos y otros temas:
```
gcloud help
```
Por ejemplo, para ver la ayuda de gcloud compute instances create, sigue estos pasos:
```
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.

Limpieza

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

Precaución: Eliminar un proyecto tiene los siguientes efectos:

Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.

Si tienes previsto consultar varias arquitecturas, tutoriales o guías de inicio rápido, reutilizar los proyectos puede ayudarte a no superar los límites de cuota de proyectos.

In the Trusted Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Siguientes pasos

Consulta la guía de la CLI de gcloud para obtener una descripción general de la CLI de gcloud, que incluye 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 Trusted Cloud.
Consulta la hoja de referencia rápida de gcloud CLI para ver una lista de los comandos y conceptos clave que se usan con frecuencia.
Instala componentes adicionales, como los emuladores de App Engine o kubectl, con el gestor de componentes de la CLI de gcloud.