Inicializar a CLI gcloud

Esta página mostra como inicializar a CLI gcloud.

Depois de instalar a CLI gcloud, execute as tarefas de configuração inicial executando o comando gcloud init. Também pode executar gcloud init para alterar as definições ou criar uma nova configuração.

gcloud init realiza os seguintes passos de configuração:

  • Autoriza a CLI gcloud a usar as credenciais da sua conta de utilizador para aceder Google Cloudou permite-lhe selecionar uma conta se tiver autorizado o acesso anteriormente
  • Configura uma configuração da CLI gcloud e define um conjunto base de propriedades, incluindo a conta ativa do passo acima, o projeto atual e, se aplicável, a região e a zona predefinidas do Compute Engine

Pode executar o seguinte como alternativa ao gcloud init:

Comando Descrição
gcloud auth login Autorize com uma conta de utilizador sem configurar uma configuração.
gcloud auth activate-service-account Autorize com uma conta de serviço em vez de uma conta de utilizador.
Útil para autorizar de forma não interativa e sem um navegador de Internet.
gcloud config [COMMAND]
gcloud config configurations [COMMAND] 		Crie e faça a gestão de configurações e propriedades da CLI gcloud.

Inicialize a CLI gcloud

Para inicializar a CLI gcloud:

  1. Corrida gcloud init:

    gcloud init

    Se estiver numa sessão de terminal remoto, pode usar a flag --no-launch-browser para impedir que o comando inicie um fluxo de autorização baseado no navegador, se necessário:

    gcloud init --no-launch-browser

  2. Crie ou selecione uma configuração, se lhe for pedido.

    Se estiver a inicializar uma nova instalação da CLI gcloud, esta gcloud init cria uma configuração denominada default para si e define-a como a configuração ativa. Se tiver configurações existentes, o gcloud init pede-lhe que escolha entre três opções: reinicializar a configuração ativa, mudar para outra e reinicializá-la ou criar uma nova.

  3. Conclua o passo de autorização quando lhe for pedido.

    Consoante tenha autorizado anteriormente o acesso aoGoogle Cloud, pode ser-lhe pedido que inicie sessão e conceda acesso num navegador de Internet ou que selecione uma conta existente.

    Se usou a flag --no-launch-browser e for necessário iniciar sessão, tem de copiar e colar o URL de autorização fornecido noutra janela do navegador e seguir as instruções apresentadas.

    Quando este passo estiver concluído, o gcloud init define a propriedade account na configuração para a conta especificada.

  4. Escolha um projeto Google Cloud atual se lhe for pedido.

    Se tiver acesso apenas a um projeto, incluindo o projeto predefinido da sua conta de utilizador, o gcloud init seleciona-o automaticamente.

    Caso contrário, pode selecionar um projeto numa lista de projetos para os quais tem autorizações de Proprietário, Editor ou Leitor. gcloud init define a propriedade project na configuração para a propriedade que escolher. Se tiver acesso a mais de 200 projetos, é-lhe pedido que introduza um ID do projeto, crie um novo projeto ou liste 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 do Compute Engine predefinida, se lhe for pedido.

    Se não tiver a API Compute Engine ativada ou já tiver uma zona predefinida nos metadados ao nível do projeto, não verá este passo. gcloud init define as propriedades region e zone na configuração através da zona que escolher.

Para ver as propriedades definidas através do comando gcloud init, use o comando gcloud config list.

[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project

O que se segue?