Guía de inicio rápido para macOS

En esta página, se muestra cómo instalar el SDK de Google Cloud, inicializarlo y ejecutar los comandos principales de gcloud desde la línea de comandos.

Antes de comenzar

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

  2. El SDK de Cloud requiere Python. Las versiones compatibles son 3.5 a 3.7, y 2.7.9 o posteriores. Para comprobar la versión de Python instalada en tu sistema, realiza lo siguiente:

    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-308.0.0-darwin-x86_64.tar.gz 85.5 MB 077c473929c2305fc7fada19319e139762b6088580ac9b5aac8b3ed8c18b78a5
    macOS de 32 bits

    (x86)

    google-cloud-sdk-308.0.0-darwin-x86.tar.gz 84.5 MB c3291537c8458be1f9b86b5e8da846c96794760766afe3af565f44f7bd6a0ef2
  4. Extrae el archivo a cualquier ubicación de tu sistema de archivos; preferentemente, en tu directorio principal. Para hacer esto en macOS, abre el archivo .tar.gz descargado en la ubicación preferida.

  5. Opcional: Usa la secuencia de comandos de instalación para agregar las herramientas del SDK de Cloud a tu ruta de acceso. 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 realizar varias tareas comunes de configuración del SDK. Algunas de estas tareas incluyen autorizar a las herramientas del SDK para acceder a Google Cloud 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
    

    Sugerencia para solucionar problemas: Si ves un error relacionado con que no se encuentra el comando de gcloud, ejecuta ./google-cloud-sdk/install.sh para usar la secuencia de comandos de instalación. Agrega herramientas del SDK de Cloud a tu PATH. Reinicia tu terminal para que los cambios tengan efecto.

  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.

  4. En el símbolo del sistema, selecciona un proyecto de Google Cloud 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 solo tienes un proyecto, gcloud init lo selecciona automáticamente.

    Si tienes acceso a más de 200 proyectos, se te pedirá que ingreses un ID del proyecto, que crees un proyecto nuevo o enumeres 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:
    
  5. Si tienes habilitada la API de Google Compute Engine, gcloud init te permite elegir una zona predeterminada de Compute Engine:

    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 confirmará si 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]
    
  6. Si deseas una experiencia de lector de pantalla más optimizada, la herramienta de línea de comandos de gcloud incluye una propiedad accessibility/screen_reader (opcional).

    Para habilitarla, ejecuta lo siguiente:

    gcloud config set accessibility/screen_reader true
    

    Para obtener más detalles sobre las funciones de accesibilidad que vienen con la herramienta de línea de comandos de gcloud, consulta la guía para habilitar funciones de accesibilidad.

Ejecuta los comandos principales de gcloud

Ejecuta estos comandos de gcloud para ver 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 del 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 información sobre los comandos de gcloud y otros temas de 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 marcas y argumentos del comando, y ejemplos de cómo usarlo.

Qué sigue