Como instalar o Google Cloud SDK

Esta página contém instruções para escolher e manter uma instalação do Cloud SDK.

Instruções para instalação

Linux
  1. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.8 e 2.7.9 ou mais recentes.

    python --version
    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
    Linux de 64 bits

    (x86_64)

    google-cloud-sdk-319.0.0-linux-x86_64.tar.gz 86,4 MB 28048af8fe83a1c80a37258d4e6c00edf22bc93edf570fb9bb6a42cca726d4c5
    Linux de 32 bits

    (x86)

    google-cloud-sdk-319.0.0-linux-x86.tar.gz 84,6 MB d54faf431374f83b08769e0ef5c126710a8ea1b3243a98ea69911d42742661ed

  4. 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-319.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-319.0.0-linux-x86.tar.gz
  5. Extraia o conteúdo do arquivo em qualquer local no sistema. Se você quer substituir uma instalação atual, remova o diretório google-cloud-sdk atual e extraia o arquivo para o mesmo local.
  6. Opcional. Use o script de instalação para adicionar ferramentas do Cloud SDK ao seu caminho. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso. Execute o script com o seguinte comando:
    ./google-cloud-sdk/install.sh
    
    Isso também pode ser feito de forma não interativa (por exemplo, com um script), 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. Execute gcloud init para inicializar o SDK:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. Opcional. Instale componentes adicionais 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 conforme descrito mais adiante nesta seção.

Pré-requisitos

Antes de instalar o SDK do Cloud, verifique se o sistema operacional é um dos seguintes:

Instalação
  1. Adicione o URI de distribuição do SDK do Cloud como a origem do pacote:
    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
    Verifique se apt-transport-https (em inglês) está instalado:
    sudo apt-get install apt-transport-https ca-certificates gnupg

    Dica para solução de problema: se a distribuição não for compatível com a opção "assinado por", execute este comando:

    echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    Dica para solução de problema: verifique se não há entradas duplicadas para o repositório cloud-sdk.

  2. Importe a chave pública do Google Cloud:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    Dica para solução de problemas: se você não estiver recebendo as atualizações mais recentes devido a uma chave expirada, consiga o arquivo de chave apt-get.gpg mais recente.

    Dica para solução de problema: se o comando apt-key da sua distribuição não for compatível com o argumento --keyring, execute este comando:

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

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

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 apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0

Red Hat/Fedora/CentOS

Conteúdo do pacote

O SDK do Cloud está disponível em formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 32 e CentOS 7. 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 nesta seção.

Instalação
  1. Atualize o DNF com as informações de repositório do SDK do Cloud:
    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-el7-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    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:
    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:

    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

macOS
  1. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.8 e 2.7.9 ou mais recentes. As versões modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud.
      python -V
      
    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-319.0.0-darwin-x86_64.tar.gz 86,7 MB 5c37fc7199141c63b6e5b1dfc55ed88ae681077fcf2e5fbd9945ad378cdf8d4e
    macOS de 32 bits

    (x86)

    google-cloud-sdk-319.0.0-darwin-x86.tar.gz 85,7 MB cbc88f1ac96504343b6f349b9289c22273f4803c64444d2161b015ff6a5c9fd6

    1. Extraia o arquivo para qualquer local no seu sistema de arquivos, de preferência no diretório principal. Para fazer isso no macOS, abra o arquivo .tar.gz baixado.

      Se você quer 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 Cloud SDK ao seu caminho. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso. Execute o script com o seguinte comando:
      ./google-cloud-sdk/install.sh
      
      Isso também pode ser feito de forma não interativa (por exemplo, com um script), fornecendo preferências como sinalizações. Eles são descritos em:
      ./google-cloud-sdk/install.sh --help
      
      Se você quer 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 as instruções. O instalador é assinado pela Google LLC.

    Se você quiser ativar o modo de leitor de tela, selecione a opção Ativar modo de leitor de tela para uma experiência mais simplificada. Para ler mais sobre a experiência do leitor de tela do SDK do Cloud, consulte o Guia de recursos de acessibilidade.

    Caixa de diálogo de boas-vindas da Configuração do SDK do Google Cloud para Windows, com caixa de seleção para ativar o modo de leitor de tela

  3. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.8 e 2.7.9 ou mais recentes.

    O instalador implantará todas as dependências necessárias, incluindo a versão necessária do Python. Mesmo que o SDK do Cloud use atualmente o Python 3 por padrão, é possível usar uma instalação atual do Python ao desmarcar a opção "Instalar Bundled Python", se necessário.

  4. Depois que a instalação for concluída, o instalador apresentará várias opções:

    Prompts do instalador do Windows

    Verifique se as opções abaixo estão selecionadas:

    • Start Google Cloud SDK Shell (Iniciar Shell do SDK do Google Cloud)
    • Run 'gcloud init' (Executar 'gcloud init')

    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 o SDK do Cloud não funcionar depois de instalar a versão 274.0.0, consulte este rastreamento de erros (em inglês) para acessar soluções alternativas.
  • Se a instalação não for bem-sucedida porque o comando find não foi reconhecido, verifique se a variável de ambiente "PATH" está definida para incluir a pasta que contém "find". Normalmente, é C:\WINDOWS\system32;.
  • Se você acabou de desinstalar o SDK do Cloud, será necessário reinicializar o sistema antes de instalar o SDK do Cloud novamente.

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.

Outras opções de instalação

Dependendo das suas necessidades de desenvolvimento, em vez da instalação recomendada, é possível usar um método alternativo de instalação do SDK do Cloud:

  • Está usando o SDK do Cloud com scripts ou implantação/integração contínua? Faça o download de um arquivo com controle de versão para uma instalação não interativa de uma versão específica do SDK do Cloud.
  • Precisa executar o SDK do Cloud como uma imagem do Docker? Use a imagem do Docker do SDK do Cloud para a versão mais recente ou específica do SDK do Cloud.
  • Você executa o Ubuntu e prefere atualizações automáticas? Use um pacote de ajuste para instalar o SDK do Cloud.
  • Para instalações interativas do Windows e do macOS e todos os outros casos de uso, execute o instalador interativo para instalar a versão mais recente do SDK do Cloud.j

O que está incluso?

Todos os métodos de instalação acima instalam os componentes padrão do SDK do Cloud, que incluem as ferramentas de linha de comando gcloud, gsutil e bq.

É possível instalar outros componentes usando o comando gcloud components install ou instalando os pacotes deb ou os pacotes RPM apropriados.

Como gerenciar uma instalação

Depois de instalar o SDK do Cloud, é possível usar comandos no grupo de comandos gcloud components para gerenciar sua instalação. Isso inclui ver os componentes instalados, adicionar e remover componentes e fazer upgrade para uma nova versão (ou downgrade para uma versão específica) do SDK do Cloud.

Versões mais antigas do Cloud SDK

Se você precisar reverter para uma versão mais antiga do SDK do Cloud, poderá encontrar todas as versões anteriores disponíveis para download neste arquivo.