Início rápido para Linux

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, se você ainda 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. Se você quiser confirmar, execute uname -m para verificar se está executando um sistema de 64 bits.

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

    (x86_64)

    google-cloud-sdk-309.0.0-linux-x86_64.tar.gz 85,2 MB c95f35e090918099a5f043a0ff80a9e15b7b91540920ae253a3114ac207b2b5b
    Linux de 32 bits

    (x86)

    google-cloud-sdk-309.0.0-linux-x86.tar.gz 83,5 MB 7fd4e2131a3b3d1c119f61546e694196313678241940671ae800e1a7e67e3475

    Como alternativa, para fazer o download do arquivo do Linux de 64 bits na linha de comando, execute:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-309.0.0-linux-x86_64.tar.gz
    

    Para fazer o download do arquivo de 32 bits, execute:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-309.0.0-linux-x86.tar.gz
    
  4. Extraia o arquivo em qualquer local no sistema de arquivos, de preferência na pasta "Início". No Linux, execute este comando para fazer isso:

    tar zxvf [ARCHIVE_FILE] google-cloud-sdk
    
  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 usando suas credenciais de 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
    

    Dica de solução de problemas: se você encontrar um erro relacionado ao comando gcloud não encontrado, execute ./google-cloud-sdk/install.sh para usar o script de instalação. Ele adiciona ferramentas do SDK do Cloud ao seu PATH. Reinicie seu terminal para que as alterações entrem em vigor.

  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.

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

    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