Instalar a CLI gcloud

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

Observação: se você estiver protegido por um proxy ou um firewall, consulte a página de configurações de proxy para mais informações sobre a instalação.

Linux

1. Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python 3 (3.5 a 3.8, 3.7 recomendado) 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.

   Desde 1º. de janeiro de 2020, a comunidade do Python não atualiza mais, corrige bugs, patches ou problemas de segurança do Python 2. Recomendamos que você faça upgrade para o Python 3 assim que possível. Para mais informações, consulte Suporte para Python 2 no Google Cloud.

2. Faça o download de um dos seguintes itens:
   Observação: para determinar a versão do SO, execute getconf LONG_BIT na linha de comando.

   Plataforma	Pacote	Tamanho	Soma de verificação SHA256
   Linux de 64 bits (x86_64)	google-cloud-cli-392.0.0-linux-x86_64.tar.gz	104,3 MB	a7e88856a07ed75cf310ebe5415c922c9b516021a6c7e66b3eb8f2859b9351bc
   Linux de 64 bits (arm)	google-cloud-cli-392.0.0-linux-arm.tar.gz	101.2 MB	6585b33a56806f95378bdfbd3f5c78f90adca1b50730639e32d674404a7e6c07
   Linux de 32 bits (x86)	google-cloud-cli-392.0.0-linux-x86.tar.gz	102,2 MB	3b466c3cfb3ea3848fec45077c2fd8d926b15724f68709235dd7ade05e051121

   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-cli-392.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-cli-392.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-cli-392.0.0-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 e extraia o arquivo para o mesmo local.

   tar -xf google-cloud-cli-392.0.0-linux-x86.tar.gz

4. Opcional. Use o script de instalação para adicionar as ferramentas da 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 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
   

5. Se você quiser enviar estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud, responda Y quando solicitado.
6. Para adicionar a CLI gcloud ao PATH e ativar o preenchimento do comando, responda Y quando solicitado.
Abra um novo terminal para as alterações entrarem em vigor.
7. Para inicializar a CLI gcloud, execute o comando gcloud init:

./google-cloud-sdk/bin/gcloud init

8. Opcional. Instale componentes extras usando o gerenciador de componentes.

Debian/Ubuntu

Observação: dependendo da sua configuração, é possível escolher outros métodos de instalação:

• Se você quiser que gcloud e gsutil sejam atualizados automaticamente para a versão mais recente enquanto você estiver executando uma versão moderna do Ubuntu que usa o Snap Package Manager, é possível instalar a Google Cloud CLI como pacote snap.
• Se você estiver usando uma instância no Compute Engine, a CLI gcloud será instalada por padrão.

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
• apt-transport-https (em inglês) está instalado:

  sudo apt-get install apt-transport-https ca-certificates gnupg

Instalação

1. Adicione o URI de distribuição da CLI gcloud como uma origem de 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

   Observação: verifique se não há entradas duplicadas para o repositório cloud-sdk em /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 a distribuição (Debian 11+ ou Ubuntu 21.10+) não for compatível com apt-key, execute o seguinte comando:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg

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

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Para mais opções de apt-get, como desativação de prompts ou simulações, consulte as páginas de manual de apt-get.

   Dica do Docker: se você estiver instalando a CLI gcloud 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-cli -y
         

   Se o comando apt-key não for compatível:

   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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
         

4. (Opcional) Instale 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-datalab
   • 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 o 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

Observação: se você estiver usando uma instância no Compute Engine, a CLI do Google Cloud estará instalada por padrão.

Conteúdo do pacote

A CLI gcloud está disponível no formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, Fedora 34, CentOS 7 e CentOs 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 CLI gcloud. 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-cli]
   name=Google Cloud CLI
   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
   

   Observação: a segunda linha de gpgkey precisa estar recuada conforme mostrado.
2. Se você estiver instalando no Fedora 34 ou 35, instale o libcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Instale a CLI gcloud.

   sudo dnf install google-cloud-cli

Observação: caso você não tenha movido para dnf no sistema, execute esses comandos usando yum.

Também é possível usar opções dnf/yum, como desativação de prompts ou simulações, com os comandos fornecidos.

4. (Opcional) Instale um dos componentes adicionais a seguir:
   • 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-datalab
   • 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 o 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 CLI gcloud, 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 modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud. 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).

     Desde 1º. de janeiro de 2020, a comunidade do Python não atualiza mais, corrige bugs, patches ou problemas de segurança do Python 2. Recomendamos que você faça upgrade para o Python 3 assim que possível. Para mais informações, consulte Suporte para Python 2 no Google Cloud.

   • Para a versão 352.0.0 e superior do SDK do Cloud, o script de instalação principal oferece a instalação do Python 3.7 do Python em Macs baseados em Intel.
   • Para mais informações sobre como escolher e configurar seu interpretador Python, consulte gcloud topic startup.
2. Faça o download de uma destas opções:
   Observação: para determinar o nome do hardware da máquina, execute uname -m em uma linha de comando.

Plataforma	Pacote	Tamanho	Soma de verificação SHA256
macOS de 64 bits (x86_64)	google-cloud-cli-392.0.0-darwin-x86_64.tar.gz	104,6 MB	08917f5a269aad838615db8d873e1b2d828649d451753babcadaa8feccf8ebc9
macOS de 64 bits (arm64, Apple M1 silicon)	google-cloud-cli-392.0.0-darwin-arm.tar.gz	103,3 MB	4a975e2320b87de80b40854e012f61493252f8b9011f11347517cd07558d6328
macOS de 32 bits (x86)	google-cloud-cli-392.0.0-darwin-x86.tar.gz	107,9 MB	8de8154f4d5aea39cb3b9c2d969340bd0dc78a6c1c91bf5b9f91a4ab16a75010

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 e extraia o arquivo para o mesmo local.

2. (Opcional) Use o script de instalação para adicionar ferramentas da CLI gcloud ao seu PATH. Também é possível ativar a conclusão do comando para o shell, a coleta de estatísticas de uso e instalar o Python 3.7.

   Execute o script (a partir da 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) e 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. Para inicializar a CLI gcloud, execute o comando gcloud init:

./google-cloud-sdk/bin/gcloud init

4. Opcional. Instale componentes extras usando o gerenciador de componentes.

Windows

A CLI do Google Cloud funciona no Windows 8.1 e no Windows Server 2012 e posterior.

1. Faça o download do Instalador da CLI do Google Cloud.

   Como alternativa, abra um terminal do PowerShell e execute os seguintes comandos:

   (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). Por padrão, a versão do SDK do Cloud para Windows vem com o Python 3 e o Python 2. Para usar o SDK do Cloud, seu sistema operacional precisa ser capaz de executar uma versão compatível do Python.

   Desde 1º. de janeiro de 2020, a comunidade do Python não atualiza mais, corrige bugs, patches ou problemas de segurança do Python 2. Recomendamos que você faça upgrade para o Python 3 assim que possível. Para mais informações, consulte Suporte para Python 2 no Google Cloud.

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

• Como usar a CLI gcloud com scripts ou a 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 uma versão 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, use comandos no grupo de comandos gcloud components para gerenciar sua instalação. Isso inclui visualização dos componentes instalados, adição e remoção de componentes e upgrade para uma nova versão ou downgrade para uma versão específica da CLI gcloud.

Observação: se você instalou a CLI gcloud usando apt-get ou yum, use apt-get ou yum para atualizar ou remover componentes. Essa funcionalidade não está disponível para gcloud components em instalações apt-get e yum.

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 mostradas anteriormente nesta página e faça login. Depois de fazer login, faça o download das versões anteriores. Para ver as versões classificadas por data, ative a opção Classificar e filtrar e clique na coluna Criado.

Versões compatíveis do Python

Desde 1º. de janeiro de 2020, a comunidade do Python não atualiza mais, corrige bugs, patches ou problemas de segurança do Python 2. Recomendamos que você faça upgrade para o Python 3 assim que possível. Para mais informações, consulte Suporte para Python 2 no Google Cloud.

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