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:
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
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 chamadadefault
para você e a definirá como a configuração ativa. Caso haja configurações existentes, ogcloud 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.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 propriedadeaccount
na configuração para a conta especificada.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 propriedadeproject
na configuração da propriedade escolhida.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 propriedadesregion
ezone
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 = user@google.com 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.