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

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

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:

# Add the Cloud SDK distribution URI as a package source
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk 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 --keyring /usr/share/keyrings/cloud.google.gpg 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 echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk 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 --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y

Soluciona problemas de instalación

Si no puedes obtener las actualizaciones más recientes debido a una clave vencida, obtén el último archivo de claves apt-get.gpg.

Si el comando apt-key de tu distribución no admite el argumento --keyring, ejecuta estos comandos en su lugar:

# Add the Cloud SDK distribution URI as a package source
echo "deb http://packages.cloud.google.com/apt cloud-sdk 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

Inicializa el SDK

Usa el comando gcloud init para realizar 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
    

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