Como inicializar a CLI gcloud

Esta página mostra como inicializar a CLI gcloud.

Depois de instalar a CLI gcloud, execute as tarefas de configuração inicial executando gcloud init. Também é possível executar gcloud init para alterar as configurações ou criar uma nova configuração.

gcloud init executa as seguintes etapas de configuração:

  • Autoriza a CLI gcloud a usar as credenciais da sua conta de usuário para acessar o Google Cloud ou permite selecionar uma conta caso você tenha um acesso autorizado anteriormente.
  • Define uma configuração da CLI gcloud e define um conjunto básico de propriedades, incluindo a conta ativa da etapa acima, o projeto atual e, se aplicável, a região e a zona padrão do Compute Engine

É possível executar o seguinte como alternativas para gcloud init:

Comando Descrição
gcloud auth login Autoriza com uma conta de usuário sem usar uma configuração.
gcloud auth activate-service-account Autoriza com uma conta de serviço em vez de com uma conta de usuário.
Útil para autorizar de maneira não interativa e sem um navegador da Web.
gcloud config [COMMAND]
gcloud config configurations [COMMAND] 		Criar e gerenciar configurações e propriedades da CLI gcloud.

Inicializar a CLI gcloud

Para inicializar a CLI gcloud:

  1. Execute gcloud init:

    gcloud init

    Se você estiver em uma sessão de terminal remota, use a sinalização --no-launch-browser para impedir que o comando inicie um fluxo de autorização baseado em navegador, se necessário:

    gcloud init --no-launch-browser

  2. Caso seja solicitado, crie ou selecione uma configuração.

    Se você estiver inicializando uma nova instalação da CLI gcloud, gcloud init criará uma configuração chamada default para você e a definirá como a configuração ativa. Se você tiver configurações atuais, gcloud init solicitará que você escolha entre três opções: reinicializar a ativa, alternar para outra e a reinicializar ou criar uma nova.

  3. Conclua a etapa de autorização quando solicitado.

    Se você já tiver um acesso previamente autorizado ao Google Cloud, talvez receba uma solicitação para fazer login e conceder acesso em um navegador da Web ou selecionar uma conta atual.

    Se você usou a sinalização --no-launch-browser e o login for necessário, copie e cole o URL de autorização em outra janela do navegador e siga as instruções.

    Quando essa etapa for concluída, gcloud init definirá a propriedade account na configuração para a conta especificada.

  4. Se solicitado, escolha um projeto atual do Google Cloud.

    Se você só tiver acesso a um projeto, incluindo o projeto padrão para sua conta de usuário, gcloud init o selecionará para você.

    Caso contrário, é possível selecionar um projeto a partir de uma lista de projetos para os que você tem as permissões de proprietário, editor ou visualizador. gcloud init define project na configuração da propriedade que você escolher. Se você tiver acesso a mais de 200 projetos, precisará inserir um ID do projeto, criar um novo projeto ou listar projetos.

    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. Se for solicitado, escolha uma zona padrão do Compute Engine.

    Se você não tiver a API Compute Engine ativada ou se já tiver uma zona padrão nos metadados para envolvidos no projeto, não verá essa etapa. gcloud init define as propriedades region e zone na configuração usando a zona que você escolher.

Para ver as propriedades definidas com o comando gcloud init, use o comando gcloud config list.

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

A seguir