Inicializar a CLI gcloud

Depois de instalar a gcloud CLI, você pode executar tarefas de configuração inicial executando gcloud init. O comando gcloud init executa as seguintes etapas:

  • Autentica com as credenciais da conta de usuário e autoriza a CLI gcloud a acessar recursos do Google Cloud em seu nome. Você também pode fazer isso separadamente com o comando gcloud auth login.

  • Determina uma configuração da CLI gcloud e define propriedades principais, como a conta ativa, o projeto atual e, se aplicável, a região e a zona padrão do Compute Engine.

Se você já inicializou a CLI gcloud, executar gcloud init de novo permite mudar as configurações atuais ou criar uma nova configuração.

Inicializar a CLI gcloud

Para inicializar a CLI gcloud:

  1. Execute gcloud init:

    gcloud init

    Se você estiver usando uma sessão de terminal remoto, adicione o --console-only flag. Essa flag fornece o URL para o fluxo de autenticação e autorização em vez de tentar abri-lo no navegador padrão. 

    gcloud init --console-only

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

    Para novas instalações da CLI gcloud, gcloud init cria uma configuração chamada default para você e a define como a configuração ativa. Se você tiver configurações atuais, gcloud init vai pedir para escolher entre as seguintes opções:

    • Reinicialize a configuração ativa.
    • Mude para outra configuração e reinicialize.
    • Criar uma nova configuração.

  3. Conclua as etapas de autenticação e autorização quando solicitado.

    Se você já tiver autorizado o acesso ao Google Cloud, talvez seja necessário fazer login de novo e conceder acesso em um navegador da Web ou selecionar uma conta atual.

    Se você usou a flag --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.

  4. Escolha um projeto do Google Cloud , se solicitado.

    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, selecione um projeto em uma lista de projetos em que você tem as funções de proprietário, editor ou leitor. Se você tiver acesso a mais de 200 projetos, precisará inserir um ID do projeto, criar um novo projeto ou listar projetos.

  5. Se for solicitado, escolha uma zona padrão do Compute Engine. Se você não tiver a API Compute Engine ativada ou já tiver uma zona padrão nos metadados no nível do projeto, essa etapa será ignorada.

Ver propriedades de configuração

Para conferir as propriedades definidas com o comando gcloud init, use o comando gcloud config list. Ele retorna uma saída semelhante ao exemplo a seguir:

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

A seguir