Instalar a CLI gcloud

Esta página contém instruções para escolher e manter uma instalação da Google Cloud CLI. A Google Cloud CLI inclui as ferramentas de linha de comando gcloud, gsutil e bq. Para uma lista de recursos da CLI gcloud, 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 a Google Cloud CLI. Para informações sobre como instalar outros componentes, como comandos da CLI gcloud no nível de versão Alfa ou Beta, consulte Como gerenciar componentes da CLI gcloud.

Linux
  1. Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python de 3.9 a 3.14. O pacote Linux x86_64 inclui um intérprete de Python em pacote que terá preferência por padrão. 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 Nome do pacote Tamanho Soma de verificação SHA256
    Linux de 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 150,5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3
    Linux de 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 57,1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2
    Linux de 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 57,1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de

    Para fazer o download do arquivo do Linux, execute o seguinte comando: 

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

    Consulte a tabela acima e substitua google-cloud-cli-linux-x86_64.tar.gz pelo nome do pacote *.tar.gz que se aplica à sua configuração.

  3. Para extrair o conteúdo do arquivo para o sistema de arquivos (preferencialmente para seu diretório inicial), execute o seguinte comando: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Opcional: para substituir uma instalação, remova o diretório google-cloud-sdk e extraia o arquivo para o mesmo local.
  4. (Opcional) Adicione a CLI gcloud 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 de instalação (na raiz da pasta extraída na última etapa) 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. Para ver as flags disponíveis, execute: 
    ./google-cloud-sdk/install.sh --help
    • (Opcional) Para enviar estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud, responda Y quando solicitado.
    • Para adicionar a CLI gcloud ao PATH e ativar o preenchimento do comando, responda Y quando solicitado.
  5. Se você atualizou o PATH na etapa anterior, abra um novo terminal para que as mudanças entrem em vigor.
  6. Para inicializar a CLI gcloud, execute o comando gcloud init: 
    7. ./google-cloud-sdk/bin/gcloud init
  7. Opcional: instale componentes extras usando o gerenciador de componentes.
Debian/Ubuntu

Conteúdo do pacote

A CLI gcloud 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 a CLI gcloud, verifique se o sistema operacional atende aos seguintes requisitos:

  • É uma versão do Ubuntu que não atingiu o fim da vida útil ou uma versão estável do Debian que não atingiu o fim da vida útil
  • Recentemente, os pacotes foram atualizados: 
    sudo apt-get update
  • Inclui o apt-transport-https e o curl instalados: 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl
Instalação
  1. Importe a Google Cloud chave pública.

    • Para distribuições mais recentes (Debian 9+ ou Ubuntu 18.04+), execute o seguinte comando:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • Para distribuições mais antigas, execute o seguinte comando: 
      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.

  2. Adicione o URI de distribuição da CLI gcloud como uma origem de pacote.
    • Para distribuições mais recentes (Debian 9+ ou Ubuntu 18.04+), 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

    • Para distribuições mais antigas que não são compatíveis 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
  3. Atualize e instale a gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Para mais opções de apt-get, como desativar prompts ou simulações, consulte as apt-get páginas do manual de.

    Dica do Docker: se você estiver instalando a gcloud CLI dentro de uma imagem Docker, use uma única etapa RUN:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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 | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    Para imagens de base mais antigas que não são compatíveis com o comando gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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-cli -y
  4. (Opcional) Instale qualquer um dos seguintes componentes adicionais:
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

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

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

Como fazer downgrade das versões da CLI gcloud

Para reverter para uma versão específica da CLI gcloud, em que VERSION é do formulário 123.0.0, execute o seguinte comando:

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

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

OBSERVAÇÃO: para versões anteriores a 371.0.0, o nome do pacote é google-cloud-sdk

Red Hat/Fedora/CentOS

Conteúdo do pacote

A CLI gcloud está disponível no formato de pacote para instalação no Red Hat Enterprise Linux 7, 8 e 9; Fedora 41 e 42; 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 DNF com informações de repositório da gcloud CLI.

    • O comando de exemplo a seguir é para instalações compatíveis com o Red Hat Enterprise Linux 7, 8 ou 9, mas certifique-se de atualizar as configurações conforme necessário para sua configuração:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • Para instalações compatíveis com o RHEL 10, use o seguinte comando com o gpgkey atualizado:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM
  2. Instale libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Instale a CLI gcloud. 
    sudo dnf install google-cloud-cli
  4. (Opcional) Instale qualquer um dos seguintes componentes adicionais:
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

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

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

Como fazer downgrade das versões da CLI gcloud

Se você quiser reverter para uma versão específica da gcloud CLI, em que VERSION seja do formulário 123.0.0, execute: sudo dnf downgrade google-cloud-cli-VERSION. Os dez lançamentos mais recentes sempre estarão disponíveis no repositório. OBSERVAÇÃO: para versões anteriores a 371.0.0, o nome do pacote é google-cloud-sdk

macOS
  1. Confirme se você tem uma versão compatível do Python:
    • Para verificar a versão atual do Python, execute python3 -V ou python -V. As versões compatíveis são Python 3.9 a 3.14.
    • O script de instalação principal oferece a instalação do Python 3.12 do CPython.
      • As ferramentas de linha de comando do Xcode são necessárias para instalar o Python.
      • Verifique se as ferramentas de linha de comando do Xcode estão instaladas executando: xcode-select -p.
      • Se as ferramentas de linha de comando do Xcode não estiverem instaladas, execute sudo xcode-select --install para instalá-las.
    • Caso contrário, para instalar uma versão compatível do Python, acesse as versões do Python para macOS (link em inglês) do Python.org.
    • Se você tem vários intérpretes de Python instalados na sua máquina, defina a variável de ambiente CLOUDSDK_PYTHON no shell para apontar para o caminho do intérprete preferido.
    • 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:

    3. Plataforma Pacote Tamanho Soma de verificação SHA256
    macOS de 64 bits

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 57,2 MB b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10
    macOS de 64 bits

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 57,1 MB b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a
    macOS de 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55,7 MB 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452
  3. 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. Ou execute o seguinte comando: 
    tar -xf google-cloud-cli-darwin-arm.tar.gz

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

  4. Execute o script de instalação (na raiz da pasta extraída na última etapa) usando o seguinte comando: 
    ./google-cloud-sdk/install.sh

    O script vai pedir para instalar o Python 3.12 e alguns módulos recomendados.

    A instalação também pode ser feita de maneira não interativa (por exemplo, usando um script) e fornecendo preferências como flags. 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
     Opcional:
    • (Opcional) Para enviar estatísticas de uso anônimas para ajudar a melhorar a gcloud CLI, responda Y quando solicitado.
    • Para adicionar a CLI gcloud ao PATH e ativar o preenchimento do comando, responda Y quando solicitado.
  5. Se você atualizou o PATH na etapa anterior, abra um novo terminal para que as mudanças entrem em vigor.
  6. Para inicializar a CLI gcloud, execute gcloud init: 
    7. ./google-cloud-sdk/bin/gcloud init
  7. Opcional. Instale componentes extras usando o gerenciador de componentes.
Windows
    A Google Cloud CLI funciona no Windows 8.1 e versões mais recentes e no Windows Server 2012 e versões mais recentes.

  1. Faça o download do Instalador da CLI do Google 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. A Google Cloud CLI requer Python. As versões compatíveis são Python 3.9 a 3.14. Por padrão, a versão para Windows da CLI do Google Cloud vem com o Python 3. Para usar a CLI do Google Cloud, seu sistema operacional precisa 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 da CLI do Google 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. Depois que a instalação for concluída, o instalador oferecerá a opção de criar os atalhos do menu e da área de trabalho, iniciar o shell da CLI do Google Cloud e configurar a CLI gcloud. 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 da CLI gcloud.
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 a CLI gcloud, é necessário reinicializar o sistema antes de instalá-la novamente.
  • Se a descompactação falhar, execute o instalador como um administrador.

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 da CLI gcloud:

  • Está usando a CLI gcloud 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 da CLI gcloud.
  • Precisa executar a CLI gcloud como uma imagem do Docker? Use a imagem do Docker da CLI gcloud para a versão mais recente ou específica da CLI gcloud.
  • Você executa o Ubuntu e prefere atualizações automáticas? Use um pacote de ajuste para instalar a CLI gcloud.
  • 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 da CLI gcloud.

Gerenciar uma instalação

Depois de instalar a CLI gcloud, é 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 da CLI gcloud.

Por exemplo, use o comando a seguir para fazer upgrade da sua versão da CLI gcloud:

gcloud components update
 Observação: se você usou apt-get ou yum para instalar a CLI gcloud, use apt-get ou yum para atualizar ou remover componentes, não gcloud components.

Versões anteriores da CLI gcloud

Se você precisar de uma versão diferente da CLI gcloud, instale a versão atual usando as instruções que aparecem anteriormente nesta página e depois faça login. Depois de fazer login, você pode baixar versões anteriores. Para ver as versões classificadas por data, ative Classificar e filtrar e clique na coluna Criado.

Versões compatíveis do Python

A CLI do Google Cloud requer Python 3.9 a 3.14. Para informações sobre como escolher e configurar o interpretador do Python, consulte gcloud topic startup.

Faça um teste

Se você começou a usar o Google Cloudagora, 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