Guia de 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 Platform, se você ainda não tiver um.

  2. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 ou mais recentes 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-280.0.0-linux-x86_64.tar.gz 56,3 MB 11950f1db216ec7dc3abaf80722fb80518c38e279bd76b6924326fe660c209cf
    Linux de 32 bits

    (x86)

    google-cloud-sdk-280.0.0-linux-x86.tar.gz 54,5 MB dfc2bc5d016e1c20d43c7bcd2f5be3063c31b924971598838978fbe25d6ac341

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-280.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-280.0.0-linux-x86.tar.gz
        
  4. Extraia o arquivo para 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 preferir, chame o SDK do Cloud depois de extrair o arquivo salvo 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 em um prompt de comando:

    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 da lista daqueles em que você tem permissão 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ê.

  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.

Executar 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:

    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.