Como inicializar o SDK do Cloud

Nesta página, mostramos como inicializar o SDK do Cloud.

Depois de instalar o SDK do Cloud, execute tarefas de configuração inicial executando gcloud init. 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:

  • 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 base de propriedades, que inclui a conta ativa da etapa acima, o projeto atual e a região e a zona padrão do 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 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.

Inicialize o SDK do Cloud

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 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 configuração 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, 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, 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 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