Início rápido para macOS

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. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.7 e 2.7.9 ou mais recentes. Para verificar a versão do Python instalada no seu sistema:

    python -V
    
  3. Faça o download do arquivo que melhor se ajuste ao seu sistema operacional. Na maioria das máquinas, será executado o pacote de 64 bits.

    Plataforma Pacote Tamanho Soma de verificação SHA256
    macOS de 64 bits

    (x86_64)

    google-cloud-sdk-293.0.0-darwin-x86_64.tar.gz 70,3 MB d6a13d7cc0791c104ac2a1a1da1f676bcd7c6fc11d0f2079f60d866f1ded94b6
    macOS de 32 bits

    (x86)

    google-cloud-sdk-293.0.0-darwin-x86.tar.gz 68,3 MB 20715c1bd1feb0eb03285251b141952643e5dceccf5222268a7d239b6f55696e
  4. Extraia o arquivo em qualquer local no sistema de arquivos, de preferência no diretório "home". No macOS, isso pode ser feito abrindo o arquivo .tar.gz salvo no local de preferência.

  5. Opcional: use o script de instalação para adicionar ferramentas do SDK do Cloud a seu caminho. Também é possível ativar a conclusão do comando para sua coleção de estatísticas de uso e seu shell bash durante o processo de instalação. Execute o script com o seguinte comando:

    ./google-cloud-sdk/install.sh
    

    Reinicie seu terminal para que as alterações entrem em vigor.

    Se você preferir, chame o Cloud SDK depois de extrair o arquivo transferido por download invocando os executáveis por meio do caminho completo.

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: se surgir um erro relacionado ao comando gcloud não ter sido encontrado, consulte a etapa 5 na seção acima.

    Observação: para impedir que o comando inicie um navegador da Web, use gcloud init --console-only. Para autorizar sem um navegador da Web e de forma não interativa, crie uma conta de serviço com os escopos apropriados usando o Console do Google Cloud Platform e usando 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:
    

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

  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

  • Leia o guia da ferramenta gcloud para uma visão geral da ferramenta de linha de comando gcloud, incluindo uma rápida introdução aos principais conceitos, convenções de comando e dicas úteis.
  • Leia o guia de referência da gcloud para páginas detalhadas sobre cada comando gcloud, incluindo descrições, sinalizações e exemplos que podem ser usados para executar diversas tarefas no Google Cloud Platform.
  • Instale componentes complementares, como os emuladores do App Engine ou kubectl, usando o gerenciador de componentes do SDK do Cloud.