Guia de início rápido: primeiros passos com o SDK do Cloud

Neste guia de início rápido, orientamos você na instalação e inicialização do SDK do Cloud, que inclui a ferramenta de linha de comando gcloud, além da execução de alguns comandos principais da ferramenta gcloud. Também é possível usar o SDK do Cloud sem instalação usando o Cloud Shell. Para orientações sobre essa alternativa, siga o tutorial interativo do Cloud SDK.

Como instalar a versão mais recente do SDK do Cloud (365.0.1)

Linux
  1. Confirme se você tem uma versão compatível do Python. O SDK do Cloud requer o Python 3 (3.5 a 3.8, 3.7) e o Python 2 (2.7.9 ou superior). Para informações sobre como escolher e configurar o interpretador do Python, consulte gcloud topic startup.
  2. Faça o download de um dos seguintes itens:
    Plataforma Pacote Tamanho Soma de verificação SHA256
    Linux de 64 bits

    (x86_64)

    google-cloud-sdk-365.0.1-linux-x86_64.tar.gz 92,7 MB 17003cdba67a868c2518ac16efa60dc6175533b7a9fb87304459784308e30fb0
    Linux de 64 bits

    (arm)

    google-cloud-sdk-365.0.1-linux-arm.tar.gz 90,1 MB fbe88d385e2648ac21bd67586c669e824160424627ac2f9c3fd17c79c765286b
    Linux de 32 bits

    (x86)

    google-cloud-sdk-365.0.1-linux-x86.tar.gz 90,1 MB 9cf354476192935d9d43db455f777e43daf2b59bb9110ff3f21d533e550916cf

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

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

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-365.0.1-linux-arm.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-365.0.1-linux-x86.tar.gz
  3. Extraia o conteúdo do arquivo em qualquer local no sistema de arquivos (preferencialmente o diretório Início). Para substituir uma instalação atual, remova o diretório google-cloud-sdk atual e extraia o arquivo para o mesmo local.
  4. Se você quiser enviar estatísticas de uso anônimas para ajudar a aprimorar o SDK do Cloud, responda Y quando solicitado.
  5. Para adicionar ferramentas de linha de comando do SDK do Cloud ao seu PATH e ativar o preenchimento do comando, responda Y quando solicitado.
  6. Opcional. Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu PATH. Também é possível ativar a conclusão do comando no shell e a coleta de estatísticas de uso.

    Execute o script na raiz da pasta extraída usando o seguinte comando:

    ./google-cloud-sdk/install.sh
    
    Isso também pode ser feito de maneira não interativa (por exemplo, usando um script) e fornecendo preferências como sinalizações. Eles são descritos em:
    ./google-cloud-sdk/install.sh --help
    
    Abra um novo terminal para as alterações entrarem em vigor.
  7. Para inicializar o SDK, execute gcloud init:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. Opcional. Instale componentes extras usando o gerenciador de componentes.
Debian/Ubuntu

Conteúdo do pacote

O SDK do Cloud está disponível no formato de pacote para instalação em sistemas Debian e Ubuntu. O pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando os comandos gcloud. Se você quiser esses componentes, instale-os separadamente.

Antes de começar

Antes de instalar o SDK do Cloud, verifique se o sistema operacional atende aos seguintes requisitos:

Instalação
  1. Adicione o URI de distribuição do SDK do Cloud como a origem do pacote. Se a distribuição for compatível com a opção "assinado por", execute o seguinte comando:
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    Se a distribuição não for compatível com a opção "assinado por", execute o seguinte comando:

    echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  2. Importe a chave pública do Google Cloud. Se o comando apt-key da distribuição for compatível com o argumento --keyring, execute o comando a seguir:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    Se o comando apt-key da sua distribuição não for compatível com o argumento --keyring, execute o seguinte comando:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    Se não for possível receber as atualizações mais recentes devido a uma chave expirada, consiga o arquivo de chave apt-get.gpg mais recente.

  3. Atualize e instale o SDK do Cloud:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Para mais opções de apt-get, como desativação de prompts ou simulações, consulte as páginas de manual de apt-get (em inglês).

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

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk 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 --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y
          
  4. Se quiser, instale qualquer um dos seguintes componentes adicionais:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Por exemplo, o componente google-cloud-sdk-app-engine-java pode ser instalado da seguinte maneira:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. Execute gcloud init para começar:
    gcloud init

Como fazer downgrade das versões do SDK do Cloud

Para reverter para uma versão específica do SDK do Cloud, em que VERSION é o formato 123.0.0, execute o seguinte comando:

sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0

As 10 versões mais recentes estão sempre disponíveis no repositório.

Red Hat/Fedora/CentOS

Conteúdo do pacote

O SDK do Cloud está disponível no formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33 e CentOS 7 e 8. O pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud, que podem ser instalados separadamente conforme descrito posteriormente nesta seção.

Instalação
  1. Atualize o DFN com as informações de repositório do SDK do Cloud: O exemplo de comando a seguir é para uma instalação compatível com o Red Hat Enterprise Linux. Para uma instalação compatível com o Red Hat Enterprise Linux 7, substitua el8 por el7 no valor de baseUrl.
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. Instale o Cloud SDK:
    sudo dnf install google-cloud-sdk
  3. Se preferir, instale qualquer um destes componentes extras:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Por exemplo, o componente google-cloud-sdk-app-engine-java pode ser instalado da seguinte maneira:

    sudo dnf install google-cloud-sdk-app-engine-java
  4. Execute gcloud init para começar:
    gcloud init

Como fazer downgrade das versões do SDK do Cloud

Se você quiser reverter para uma versão específica do SDK do Cloud, em que VERSION esteja no formato 123.0.0, execute: sudo dnf downgrade google-cloud-sdk-VERSION Os 10 lançamentos mais recentes sempre estarão disponíveis no repositório.

macOS
  1. Confirme se você tem uma versão compatível do Python:
    • As versões compatíveis são Python 3 (3.5 a 3.8, 3.7 recomendada) e Python 2 (2.7.9 ou superior).
    • As versões modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud. Para verificar a versão atual do Python, execute python -V.
    • Para a versão de lançamento 352.0.0 e mais recentes do SDK do Cloud, o script de instalação principal oferece a instalação do Python 3.7 do CPython em Macs baseados em Intel.
    • Para mais informações sobre como escolher e configurar seu interpretador do Python, consulte gcloud topic startup.
  2. Faça o download de um dos seguintes itens:
  3. Plataforma Pacote Tamanho Soma de verificação SHA256
    macOS de 64 bits

    (x86_64)

    google-cloud-sdk-365.0.1-darwin-x86_64.tar.gz 93.2 MB 4ae8a3274eb9b6fca5761ef2eed713bc3486256d11268575febe3351e9e4d902
    macOS de 64 bits

    (arm64, Apple M1 Silicon)

    google-cloud-sdk-365.0.1-darwin-arm.tar.gz 93.2 MB 636591e597730649011f510fc8c78e2b133ef8b417992f8d923a87a528dc6d5e
    macOS de 32 bits

    (x86)

    google-cloud-sdk-365.0.1-darwin-x86.tar.gz 97.0 MB b3b04f7f5577347d5c30277d4bf6aa2d1a182c1ff8f9cc04edf0dee6f0b8c4a9

    1. Extraia o arquivo para qualquer local no seu sistema de arquivos, de preferência no diretório principal. No macOS, isso pode ser feito abrindo o arquivo .tar.gz salvo no local de preferência.

      Para substituir uma instalação atual, remova o diretório google-cloud-sdk atual e extraia o arquivo para o mesmo local.

    2. Opcional. Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu PATH.

      Também é possível ativar a conclusão do comando para a coleta e a coleta de estatísticas de uso do shell e, opcionalmente, instalar o Python 3.7.

      Execute o script (na raiz da pasta extraída na última etapa) usando este comando:

      ./google-cloud-sdk/install.sh
      
      Isso também pode ser feito de maneira não interativa (por exemplo, usando um script) fornecendo preferências como sinalizações. Para descrever as sinalizações disponíveis, execute:
      ./google-cloud-sdk/install.sh --help
      
      Para executar o script de instalação com o modo de leitor de tela ativado:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      Abra um novo terminal para as alterações entrarem em vigor.
    3. Execute gcloud init para inicializar o SDK:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Opcional. Instale componentes adicionais usando o gerenciador de componentes.
Windows
  1. Faça o download do Instalador do SDK do Cloud.

    Se preferir, abra um terminal do PowerShell e execute os comandos a seguir:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
    
    & $env:Temp\GoogleCloudSDKInstaller.exe
        
  2. Inicie o instalador e siga os prompts. O instalador é assinado pela Google LLC.

    Se você estiver usando um leitor de tela, marque a caixa de seleção Ativar modo leitor de tela. Essa opção configura gcloud para usar rastreadores de status em vez de spinners unicode, exibir o progresso como uma porcentagem e nivelar tabelas. Para mais informações, consulte o Guia de recursos de acessibilidade.

  3. O SDK do Cloud requer o Python. As versões compatíveis são Python 3 (preferencial, 3.5 a 3.8) e Python 2 (2.7.9 ou superior). O SDK do Cloud vem com o Python 3 por padrão. Para usar o SDK do Cloud, seu sistema operacional precisa ser capaz de executar uma versão compatível do Python.

    O instalador instala todas as dependências necessárias, incluindo a versão necessária do Python. Embora o SDK do Cloud instale e gerencie o Python 3 por padrão, é possível usar uma instalação atual do Python ao desmarcar a opção de instalar o Bundled Python, se necessário. Consulte gcloud topic startup para aprender a usar uma instalação atual do Python.

  4. Após a conclusão da instalação, o instalador oferece a opção de criar os atalhos do menu Iniciar e na área de trabalho, iniciar o shell do SDK do Cloud e configurar o SDK do Cloud. Deixe as opções para iniciar o shell e configurar a instalação selecionadas. O instalador inicia uma janela de terminal e executa o comando gcloud init.

  5. A instalação padrão não inclui as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud. Para instalar esses componentes, use o gerenciador de componentes do SDK do Cloud.
Dicas de solução de problemas:
  • 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ê desinstalou o SDK do Cloud, é necessário reinicializar o sistema antes de instalá-lo novamente.
  • Se a descompactação falhar, execute o instalador como um administrador.

Opcional: instalar as bibliotecas de cliente mais recentes do Google Cloud

É possível fazer o download das Bibliotecas de cliente do Cloud para as linguagens compatíveis.

Como inicializar o SDK do Cloud

Use o comando gcloud init para executar várias tarefas comuns de configuração do SDK do Cloud. Entre elas: autorizar as ferramentas do SDK do Cloud a acessar o Google Cloud usando as credenciais da sua conta de usuário e definir a configuração padrão.

Para inicializar o SDK do Cloud:

  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.

  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) Para uma experiência mais otimizada do leitor de tela, a ferramenta 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 vêm com a ferramenta gcloud, consulte o guia Como ativar recursos de acessibilidade.

Como executar comandos principais

Execute estes comandos da ferramenta gcloud para visualizar informações sobre a instalação do SDK do Cloud:

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

    gcloud auth list
    

    A ferramenta 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 do Cloud:

     gcloud config list
    

    A ferramenta 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 sobre a instalação do SDK do Cloud e a configuração ativa:

    gcloud info
    

    A ferramenta gcloud exibe um resumo das informações sobre a instalação do SDK do Cloud. Isso inclui informações sobre o sistema, os componentes instalados, a conta de usuário ativa, o projeto atual e as propriedades da configuração ativa.

  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
    

    A ferramenta 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.

A seguir

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Comece a usar gratuitamente