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
  • Configura um SDK do Cloudconfiguração e define um conjunto básicopropriedades, incluindo a conta ativa da etapa acima, o projeto atual e, se aplicável, a região e a zona padrão do Compute Engine

É 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.

Inicializar 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 e a definirá como a configuração ativa. Se você tiver configurações atuais, o gcloud init solicitará que você escolha entre três opções: reinicializar a ativa, alternar para outra e reiniciá-la ou criar uma nova.

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

    Se você tiver autorizado o acesso ao Google Cloud anteriormente, talvez seja necessário 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, será possível selecionar um projeto de uma lista de projetos para os quais você tem permissões de proprietário, editor ou visualizador. gcloud init define a propriedade project na configuração para a propriedade escolhida. 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. Escolha uma zona padrão do Compute Engine, se solicitado.

    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 escolhida.

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