Início rápido para Windows

Nesta página, você verá como instalar o SDK do Google Cloud, inicializá-lo e executar os principais comandos gcloud a partir da 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 do instalador do Windows

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

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

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

Dicas para solução de problemas:

  • Se o SDK do Cloud não funcionar depois de instalar a versão 274.0.0, consulte este rastreamento de erros (em inglês) para acessar soluções alternativas.
  • Se a instalação não for bem-sucedida devido ao comando find não ter sido reconhecido, verifique se sua variável de ambiente PATH está definida para incluir a pasta que contém find. Geralmente, isso é C:\WINDOWS\system32;.
  • Se você acabou de desinstalar o SDK do Cloud, será necessário reinicializar o sistema antes de instalar o SDK do Cloud novamente.

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
    

  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:
    

    Se você tiver apenas um projeto, gcloud init o selecionará para você.

    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 a API do Google Compute Engine estiver ativada, 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:
    

    gcloud init confirma que você concluiu as etapas de configuração corretamente:

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    
  6. (Opcional) Se você quiser uma experiência de leitor de tela mais otimizada, a ferramenta de linha de comando gcloud vem com uma propriedade accessibility/screen_reader.

    Para ativar essa propriedade, execute:

    gcloud config set accessibility/screen_reader true
    

    Para mais detalhes sobre os recursos de acessibilidade que acompanham a ferramenta de linha de comando gcloud, consulte este guia.

Execute comandos gcloud básicos

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

  1. Para listar contas com as credenciais armazenadas no sistema local:

    gcloud auth list
    

    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
    

    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
    

    gcloud exibe um resumo das 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 visualizar informações sobre os comandos gcloud e outros tópicos na linha de comando:

    gcloud help
    

    Por exemplo, para visualizar a ajuda para gcloud compute instances create:

    gcloud help compute instances create
    

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

A seguir