Como inicializar o Cloud SDK

Nesta página, você verá como inicializar o SDK do Google Cloud.

Depois de instalar o SDK do Cloud, a próxima etapa é executar o comando gcloud init para realizar as tarefas de configuração inicial. Também é possível executar gcloud init posteriormente para alterar ou criar uma nova configuração.

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

  • Dá autorização para as ferramentas do SDK do Cloud usarem as credenciais de sua conta de usuário para acessar o Google Cloud ou permite que você selecione uma conta se tiver um acesso previamente autorizado
  • Determina a configuração do SDK do Cloud e define um conjunto básico de propriedades, que inclui a conta ativa da etapa acima, o projeto atual e a região e a zona padrão do Google Compute Engine, se aplicável.

É 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 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]
Cria e gerencia configurações e propriedades do SDK do Cloud.

Executar gcloud init

Para inicializar o SDK do Cloud siga estas etapas:

  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 do SDK do Cloud, gcloud init criará uma nova 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, poderá ser solicitado a fazer login e conceder acesso em um navegador da Web ou selecionar uma conta existente.

    Se você usou a sinalização --console-only e o login for necessário, recorte e cole o URL de autorização fornecido em outra janela do navegador e siga as instruções fornecidas.

    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 Google Compute Engine.

    Se a API do Compute Engine não estiver ativada ou se já tiver uma zona padrão nos seus metadados para envolvidos no projeto, você 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