Guía de inicio rápido para macOS

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

  1. Crea un proyecto de Google Cloud Platform, si todavía no tienes uno.

  2. Asegúrate de que Python 2.7 esté instalado en tu sistema:

    python -V

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

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

  5. Opcional: Si tienes problemas para hacer funcionar el comando de gcloud, 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 shell bash 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:

  1. 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 usa gcloud auth activate-service-account con el archivo de claves JSON correspondiente.

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

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

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

  5. 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:

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

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

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

  4. 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 de gcloud, 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 de gcloud, 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.