Esta página muestra cómo instalar el SDK de Google Cloud, inicializarlo y ejecutar los comandos de gcloud
principales desde la línea de comandos.
Antes de comenzar
Crea un proyecto de Google Cloud Platform, si todavía no tienes uno.
Asegúrate de que Python 2.7 esté instalado en tu sistema:
python -V
Descarga el archivo más adecuado para tu sistema operativo. La mayoría de las máquinas utilizarán el paquete de 64 bits.
Plataforma Paquete Tamaño Suma de verificación SHA256 macOS de 64 bits (x86_64)
google-cloud-sdk-231.0.0-darwin-x86_64.tar.gz 18.1 MB 15106429ba8de742a38e94b6b85c2aeb3cc8af02d09325ca4def345124d5ac66 macOS de 32 bits (x86)
google-cloud-sdk-231.0.0-darwin-x86.tar.gz 18.1 MB 9719c9dc0f643fbfb7e617947c4b93c9adc588821ed03ee7c07bf5f9907cef23 Extrae el archivo a cualquier ubicación de tu sistema de archivos; preferentemente, en tu directorio principal. En macOS, esto se logra abriendo el archivo
.tar.gz
descargado en la ubicación preferida.Opcional: Si tienes problemas para hacer funcionar el comando degcloud
, asegúrate de que tu$PATH
esté definida correctamente. Usa la secuencia de comandos de instalación para agregar las herramientas del SDK de Cloud a tu ruta. También podrás habilitar la finalización de comandos para tu shellbash
y la recopilación de estadísticas de uso durante el proceso de instalación. Ejecuta la secuencia de comandos con este comando:./google-cloud-sdk/install.sh
Reinicia tu terminal para que los cambios tengan efecto.
Como alternativa, para llamar al SDK de Cloud después de extraer el archivo descargado, invoca sus ejecutables a través de su ruta completa.
Inicializa el SDK
Usa el comando gcloud init
para ejecutar varias tareas comunes de configuración del SDK. Estas tareas incluyen la autorización de las herramientas del SDK para acceder a Google Cloud Platform con las credenciales de tu cuenta de usuario y establecer la configuración predeterminada del SDK.
Cómo inicializar el SDK:
Ejecuta el siguiente comando en un símbolo de sistema:
gcloud init
Nota: Para evitar que el comando inicie un navegador web, usa
gcloud init --console-only
en su lugar. Para autorizar el acceso sin un navegador web y de forma no interactiva, crea una cuenta de servicio con los alcances apropiados a través de Google Cloud Platform Console y usagcloud auth activate-service-account
con el archivo de claves JSON correspondiente.Acepta la opción para acceder 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, accede a tu cuenta de usuario de Google cuando se te solicite y haz clic en Permitir para autorizar el acceso a los recursos de Google Cloud Platform.
En el símbolo del sistema, selecciona un proyecto de Cloud Platform de la lista de aquellos en los que tienes permiso de Propietario, Editor o Lector:
Pick cloud project to use: [1] [my-project-1] [2] [my-project-2] ... Please enter your numeric choice:
Si únicamente tienes un proyecto,
gcloud init
lo selecciona por ti.Si tienes la API de Google Compute Engine habilitada,
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 completaste los pasos de configuración correctamente:gcloud has now been configured! You can use [gcloud config] to change more gcloud settings. Your active configuration is: [default]
Ejecuta los comandos principales de gcloud
Ejecuta estos comandos de gcloud
para obtener información sobre la instalación del SDK:
Para enumerar las cuentas cuyas credenciales están guardadas en el sistema local:
gcloud auth list
gcloud
muestra una lista de cuentas con credenciales:Credentialed Accounts ACTIVE ACCOUNT * example-user-1@gmail.com example-user-2@gmail.com
Para enumerar las propiedades en tu configuración del SDK activa:
gcloud config list
gcloud
muestra la lista de propiedades:[core] account = example-user-1@gmail.com disable_usage_reporting = False project = example-project
Para ver la información sobre la instalación de tu SDK de Cloud y la configuración del SDK activa:
gcloud info
gcloud
muestra un resumen de la información sobre la instalación de tu SDK de Cloud. Este incluye información sobre tu sistema, los componentes del SDK instalados, el proyecto actual y la cuenta de usuario activa, y las propiedades en la configuración del SDK activa.Para ver la información sobre los comandos de
gcloud
y otros temas desde la línea de comandos:gcloud help
Por ejemplo, para ver la ayuda de
gcloud compute instances create
:gcloud help compute instances create
gcloud
muestra un tema de ayuda que contiene una descripción del comando, una lista de argumentos y marcas del comando, y ejemplos de cómo usarlo.
¿Qué sigue?
- Lee la guía de la herramienta de
gcloud
para obtener una descripción general de la herramienta de línea de comandos degcloud
, que incluye una introducción rápida a los conceptos clave, convenciones de comandos y sugerencias útiles. - Lee la guía de referencia de
gcloud
para consultar páginas detalladas sobre cada comando degcloud
, que incluyen descripciones, marcas y ejemplos que puedes usar para realizar diversas tareas en Google Cloud Platform. - Instala componentes adicionales como los emuladores de App Engine o
kubectl
mediante el administrador de componentes del SDK de Cloud.