Como inicializar a CLI gcloud

Nesta página, mostramos como inicializar a CLI gcloud.

Depois de instalar a CLI gcloud, execute gcloud init para executar as tarefas de configuração inicial. 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 da gcloud a usar as credenciais da conta de usuário para acessar o Google Cloud ou permite selecionar uma conta caso você tenha autorizado anteriormente
  • Configura uma CLI gcloudconfiguração e define um conjunto básicopropriedades, 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] Crie e gerencie configurações e propriedades da CLI da 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 --console-only para impedir que o comando inicie um fluxo de autorização baseado em navegador, se necessário:

    gcloud init --console-only
    
  2. Caso seja solicitado, crie ou selecione uma configuração.

    Se você estiver inicializando uma nova instalação da CLI da gcloud, gcloud init criará uma configuração chamada default 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 --console-only e o login for necessário, copie e cole o URL de autorização fornecido em outra janela do navegador e siga as instruções exibidas.

    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.

Quando gcloud init for concluído, ele imprimirá as propriedades na configuração ativa no terminal:

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

É possível visualizar essas propriedades a qualquer momento usando o comando gcloud config list.

A seguir