Inicializa gcloud CLI

En esta página, se muestra cómo inicializar gcloud CLI.

Después de instalar gcloud CLI, ejecuta gcloud init para realizar las tareas de configuración iniciales. También puedes ejecutar gcloud init para cambiar la configuración o crear una nueva.

gcloud init realiza los siguientes pasos de configuración:

  • Autoriza a gcloud CLI a usar tus credenciales de cuenta de usuario para acceder a Google Cloud, o te permite seleccionar una cuenta si ya tienes una autorización de acceso previa.
  • Establece una configuración de gcloud CLI y un conjunto base de propiedades, que incluye la cuenta activa del paso anterior, el proyecto actual y, si corresponde, la zona y la región predeterminadas de Compute Engine.

Puedes ejecutar lo siguiente como alternativas a gcloud init:

Comando Descripción
gcloud auth login Autoriza una cuenta de usuario sin establecer una configuración.
gcloud auth activate-service-account Autoriza una cuenta de servicio en lugar de una de usuario.
Es útil para autorizar de forma no interactiva y sin un navegador web.
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
Crea y administra parámetros de configuración y propiedades de gcloud CLI.

Inicializa gcloud CLI

Para inicializar gcloud CLI, haz lo siguiente:

  1. Ejecuta gcloud init:

    gcloud init
    

    Si te encuentras en una sesión de terminal remota, puedes usar la marca --no-launch-browser para evitar que el comando inicie un flujo de autorización basado en el navegador, si es necesario:

    gcloud init --no-launch-browser
    
  2. Crea o selecciona una configuración si se te solicita.

    Si inicializas una instalación nueva de gcloud CLI, gcloud init crea una configuración llamada default y la establece como la configuración activa. Si tienes configuraciones existentes, gcloud init te indica que elijas entre tres opciones: volver a inicializar la activa, cambiar a otra y volver a inicializarla o crear una nueva.

  3. Completa el paso de autorización cuando se te solicite.

    Según si has autorizado previamente el acceso a Google Cloud, es posible que se te solicite que accedas y que concedas acceso en un navegador web, o que selecciones una cuenta existente.

    Si usaste la marca --no-launch-browser y se requiere el acceso, debes copiar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir las instrucciones proporcionadas.

    Cuando se completa este paso, gcloud init establece la propiedad account en la configuración de la cuenta especificada.

  4. Elige un proyecto actual de Google Cloud si se te solicita.

    Si solo tienes acceso a un proyecto, incluido el proyecto predeterminado para tu cuenta de usuario, gcloud init lo selecciona automáticamente.

    De lo contrario, puedes seleccionar un proyecto de una lista de proyectos para los cuales tienes permisos de propietario, editor o visualizador. gcloud init establece la propiedad project en la configuración de la propiedad que elijas. 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. Elige una zona predeterminada de Compute Engine, si se te solicita.

    Si no tienes habilitada la API de Compute Engine o si ya tienes una zona predeterminada en tus metadatos a nivel de proyecto, no verás este paso. gcloud init establece las propiedades region y zone en la configuración con la zona que elijas.

Para ver las propiedades configuradas a través del comando gcloud init, usa el comando gcloud config list.

[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project

¿Qué sigue?