Como inicializar o Cloud SDK

Esta página mostra como inicializar o Google Cloud SDK.

Geralmente, o próximo passo depois de instalar o SDK do Cloud é executar o comando gcloud init para realizar as tarefas de configuração inicial. Você também pode executar o gcloud init mais tarde para alterar suas configurações ou criar uma nova configuração.

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

• Autoriza as ferramentas do SDK do Cloud a usar as credenciais da sua conta para acessar o Google Cloud Platform ou permite que você selecione uma conta caso tenha 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 as seguintes alternativas ao 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]	Cria e gerencia configurações e propriedades do Cloud SDK.

Executar gcloud init

Para inicializar o Cloud SDK:

1. Execute gcloud init:

   gcloud init
   

   Se você estiver em uma sessão de terminal remota, use a sinalização --console-only para impedir o comando de iniciar um fluxo de autorização baseado no navegador, caso necessário:

   gcloud init --console-only
   

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

   Se estiver inicializando uma nova instalação do Cloud SDK, o gcloud init criará uma nova chamada default para você e a definirá como a configuração ativa. Caso haja configurações existentes, o gcloud init solicitará que você escolha entre três opções: reinicialize a configuração ativa, mude para outra e a reinicialize, ou crie uma nova.

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

   Se você já tiver um acesso previamente autorizado ao Cloud Platform, poderá receber uma solicitação para fazer login e conceder acesso em um navegador da Web, ou selecionar uma conta existente.

   Se usou a sinalização --console-only e o login for necessário, você terá que recortar e colar o URL de autorização em outra janela do navegador e seguir os prompts fornecidos.

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

4. Se for solicitado, escolha um projeto atual do Cloud Platform.

   Se tiver acesso a apenas um projeto, incluindo o projeto padrão de sua conta de usuário, gcloud init seleciona-o para você. Caso contrário, será possível selecionar um projeto em uma lista de projetos em que você tenha as permissões proprietário, editor ou leitor. gcloud init define a propriedade project na configuração da propriedade escolhida.

5. Se for solicitado, escolha uma zona padrão do Google Compute Engine.

   Se a API do Compute Engine não estiver ativada ou você já tiver uma zona padrão nos metadados no nível do projeto, você não verá essa etapa. gcloud init define as propriedades region e zone na configuração da zona escolhida.

Quando gcloud init terminar, ele imprimirá as propriedades na configuração ativa do terminal:

[compute]
region = us-east1
zone = us-east1-b
[core]
account = [e-mail]
disable_usage_reporting = False
project = example-project

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

A seguir

• Leia Como autorizar ferramentas do SDK do Cloud para saber mais sobre autorização de ferramentas.
• Leia Configurações do SDK do Cloud para saber mais sobre configurações.
• Leia Propriedades do SDK do Cloud para saber mais sobre configurações.