Guía de inicio rápido para Debian y Ubuntu

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

Asegúrate de que tu sistema operativo sea uno de los siguientes:

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

Luego, realiza los pasos a continuación:

# Create environment variable for correct distribution
export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"

# Add the Cloud SDK distribution URI as a package source
echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

# Import the Google Cloud Platform public key
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

# Update the package list and install the Cloud SDK
sudo apt-get update && sudo apt-get install google-cloud-sdk

Sugerencia de Docker: Si estás instalando el SDK de Cloud dentro de una imagen de Docker, mejor usa un solo paso RUN:

RUN export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)" && \
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && \
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - && \
    apt-get update -y && apt-get install google-cloud-sdk -y

Sugerencia para la solución de problemas: Si no puedes obtener las últimas actualizaciones debido a una clave vencida, obtiene el último archivo de claves apt-get.gpg.

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 los paquetes APT del SDK de Cloud adicionales.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del SDK de Cloud