Instalar o SDK do Cloud

Esta página contém instruções para escolher e manter uma instalação do Cloud SDK. O SDK do Cloud inclui as ferramentas de linha de comando gcloud, gsutil e bq. Para uma lista de recursos do SDK do Cloud, consulte Todos os recursos.

Para acessar as APIs do Google Cloud com uma linguagem de programação compatível, faça o download das bibliotecas de cliente do Cloud.

Instruções para instalação

Estas instruções mostram como instalar o SDK do Cloud. Para ver informações sobre como instalar outros componentes, como comandos da ferramenta gcloud no nível de versão Alfa ou Beta, consulte Como gerenciar componentes do SDK.

Linux
  1. 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).

    python --version
    Seu sistema operacional precisa ser capaz de executar uma dessas versões compatíveis do Python para que o SDK do Cloud seja executado. 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 itens a seguir:
  3. Plataforma Pacote Tamanho Soma de verificação SHA256
    Linux de 64 bits

    (x86_64)

    google-cloud-sdk-360.0.0-linux-x86_64.tar.gz (link em inglês) 92,3 MB 6192cb2791f592da6d372888dbd7ee81d3d91f255d844ab5fc518fc97e453648
    Linux de 64 bits

    (arm)

    google-cloud-sdk-360.0.0-linux-arm.tar.gz (link em inglês) 89.6 MB 19cb40f5678c652c0960cf6e4e8faa896754f6a6dd3716701126063cac3b61ca
    Linux de 32 bits

    (x86)

    google-cloud-sdk-360.0.0-linux-x86.tar.gz (link em inglês) 89.6 MB aabf563e3f9b467b123f6ee2bff0017eaec5c154458c623ec8a59306d72194ea

  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-360.0.0-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-360.0.0-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-360.0.0-linux-x86.tar.gz
  5. Extraia o conteúdo do arquivo em qualquer local no sistema de arquivos (preferencialmente o diretório Início). 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 SDK do Cloud ao seu PATH. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso.

    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 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
  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 -
  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 Os 10 lançamentos mais recentes sempre estarão 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 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-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. O SDK do Cloud exige o Python:
    • As versões compatíveis são Python 3 (3.7 é recomendada) e Python 2 (2.7.9 ou versões mais recentes).
    • 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-360.0.0-darwin-x86_64.tar.gz (em inglês) 92,8 MB b900370f1c05f2dbf819aa257c545790ef087f858f0e438eac20ed0bed375e32
    macOS de 64 bits

    (arm64, Apple M1 Silicon)

    google-cloud-sdk-360.0.0-darwin-arm.tar.gz (em inglês) 92,7 MB 7d40e2282958d713ebb5ce8fa7c28ccb4787f2cd304c2ee1f5bf9c91f4f00b5e
    macOS de 32 bits

    (x86)

    google-cloud-sdk-360.0.0-darwin-x86.tar.gz (em inglês) 96,6 MB 4159f7419b8abe7de7bddb88ced85bf547cbc49c488801b3f06ee9188474a33f

    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.

      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 SDK do Cloud ao seu PATH.

      Também é possível usar a conclusão do comando no seu shell e a coleção de estatísticas de uso 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 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 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 saber como usar uma instalação existente 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ê acabou de desinstalar o SDK do Cloud, reinicialize o sistema antes de instalá-lo novamente.

Outras opções de instalação

Dependendo das suas necessidades de desenvolvimento, em vez da instalação recomendada, use 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 uma versão 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

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 a visualização de componentes instalados, a adição e remoção de componentes e o 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 de uma versão mais antiga do SDK do Cloud, poderá fazer o download das versões anteriores.

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 ganham US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Comece gratuitamente