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 en 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. Algunas de estas tareas incluyen autorizar a 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: Si se produce un error relacionado con la ausencia del comando de gcloud, consulta el paso 5 de la sección anterior.

    Nota: Para evitar que el comando inicie un navegador web, usa gcloud init --console-only en su lugar. Para autorizar sin un navegador web y de forma no interactiva, crea una cuenta de servicio con los permisos adecuados mediante 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 solo tienes un proyecto, gcloud init lo selecciona automáticamente.

  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 información sobre la instalación del SDK de Cloud y la configuración activa del SDK, sigue estos pasos:

    gcloud info
        

    gcloud muestra un resumen de la información sobre la instalación del SDK de Cloud. Esto incluye información sobre tu sistema, los componentes del SDK instalados, la cuenta de usuario activa, el proyecto actual y las propiedades en la configuración activa del SDK.

  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

  • Consulta la guía de la herramienta gcloud para obtener una descripción general de la herramienta de línea de comandos gcloud, que incluye una introducción rápida a los conceptos clave, objetivos de los comandos y sugerencias útiles.
  • Consulta la guía de referencia de gcloud para obtener información detallada sobre cada comando gcloud, incluidos descripciones, marcas y ejemplos que puedes usar para realizar diversas tareas en Google Cloud Platform.
  • Instala los paquetes APT del SDK de Cloud adicionales.