Guia de início rápido para Debian e Ubuntu

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

Antes de começar

Verifique se o sistema operacional é um dos seguintes itens:

Crie um projeto do Google Cloud Platform, se você não tiver um.

Em seguida, realize as seguintes etapas:

# Create environment variable for correct distribution
export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"

# Add the Cloud SDK distribution URI as a package source
echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

# Import the Google Cloud Platform public key
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

# Update the package list and install the Cloud SDK
sudo apt-get update && sudo apt-get install google-cloud-sdk

Dica do Docker: se você estiver instalando o SDK do Cloud dentro de uma imagem do Docker, use uma única etapa RUN:

RUN export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)" && \
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && \
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - && \
    apt-get update -y && apt-get install google-cloud-sdk -y

Dica de solução de problemas: pode ser necessário instalar o lsb_release para recuperar o nome correto da versão Canonical.

Dica de solução de problemas: caso não consiga receber as atualizações mais recentes devido a uma chave expirada, solicite o arquivo de chave apt-get.gpg mais recente.

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.

Próximas etapas

  • Leia o guia da ferramenta gcloud para ter uma visão geral da 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 do gcloud para ter acesso a páginas detalhadas sobre cada comando do gcloud, incluindo descrições, sinalizações e exemplos usados para executar uma série de tarefas no Google Cloud Platform.
  • Instale outros pacotes APT do SDK do Cloud.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK