Guia de início rápido para Windows

Nesta página, você aprende como instalar e inicializar o SDK do Google Cloud e como executar os comandos principais da gcloud usando a linha de comando.

Antes de começar

  1. Crie um projeto do Google Cloud Platform, se você não tiver um.
  2. Faça o download do Instalador do SDK do Google Cloud.

  3. Inicie o instalador e siga as instruções.

  4. Depois que a instalação for concluída, o instalador apresenta várias opções:

    Prompts de instalação do Windows

    Verifique se as opções abaixo estão selecionadas:

    • Start Google Cloud SDK Shell (Iniciar Shell do Google Cloud SDK)
    • Run 'gcloud init' (Executar 'gcloud init')

    O instalador abre uma janela de terminal e executa o comando gcloud init.

Dicas para solução de problemas:

  • Caso a instalação não funcione devido a uma falha de reconhecimento do comando find, verifique se a variável de ambiente PATH está configurada para incluir a pasta que contém find. Normalmente, é a C:\WINDOWS\system32;.
  • Se tiver desinstalado o SDK do Cloud anteriormente, será necessário reinicializar o sistema antes de instalá-lo novamente. Consulte este bug para mais detalhes.

Inicializar o SDK

Use o comando gcloud init para executar várias tarefas comuns de configuração do SDK, entre elas: autorizar as ferramentas do SDK a acessar o Google Cloud Platform usando as credenciais da sua conta de usuário e definir a configuração padrão do SDK.

Para iniciar o SDK:

  1. Execute o seguinte comando em um prompt:

    gcloud init
    

    Observação: para evitar que o comando inicialize um navegador da Web, use gcloud init --console-only. Para fornecer uma autorização sem um navegador da Web e de modo não interativo, crie uma conta de serviço com os escopos adequados no Console do Google Cloud Platform e use gcloud auth activate-service-account com o arquivo de chave JSON correspondente.

  2. Aceite a opção de fazer login com sua conta de usuário do Google:

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. No seu navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir acesso aos recursos do Google Cloud Platform.

  4. No prompt de comando, selecione um projeto do Cloud Platform na lista de projetos em que você tem as permissões de proprietário, editor ou leitor:

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    Caso você tenha apenas um projeto, o comando gcloud init fará a seleção dele automaticamente.

  5. Se a API do Google Compute Engine estiver ativada, o comando gcloud init permitirá que você escolha uma zona padrão do Compute Engine:

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    O comando gcloud init confirma se você concluiu as etapas de configuração:

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    

Executar comandos básicos do gcloud

Execute estes comandos do gcloud para exibir informações sobre a instalação do SDK:

  1. Para listar contas cujas credenciais estão armazenadas no sistema local:

    gcloud auth list
    

    O gcloud exibe uma lista de contas credenciadas:

           Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. Para listar as propriedades na configuração ativa do SDK:

    gcloud config list
    

    O gcloud exibe a lista de propriedades:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. Para ver informações de instalação do SDK do Cloud e de configuração ativa do SDK, use o comando:

    gcloud info
    

    O gcloud exibe um resumo de informações sobre a instalação do SDK do Cloud. Isso inclui informações sobre o sistema, os componentes do SDK instalados, a conta de usuário ativa, o projeto atual e as propriedades da configuração ativa do SDK.

  4. Para ver informações sobre comandos do gcloud e outros tópicos da linha de comando, use o comando:

    gcloud help
    

    Para ver a ajuda para gcloud compute instances create, por exemplo:

    gcloud help compute instances create
    

    O gcloud exibe um tópico de ajuda que contém uma descrição do comando e uma lista de sinalizações e argumentos de comando, além de exemplos de como usá-lo.

A seguir

  • Leia o guia da ferramenta gcloud para ter uma visão geral sobre a ferramenta de linha de comando gcloud, incluindo uma rápida introdução aos principais conceitos e às convenções de comandos, além de dicas úteis.
  • Leia o guia de referência da gcloud para ter acesso a páginas detalhadas sobre cada comando da gcloud, incluindo descrições, sinalizações e exemplos usados para executar uma série de tarefas no Google Cloud Platform.
  • Instale outros componentes, como emuladores do App Engine ou kubectl, com o gerenciador de componentes do SDK do Cloud
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK