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 conferir uma lista dos 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 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.
- Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer
o Python de 3.8 a 3.11. 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
. - 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-455.0.0-linux-x86_64.tar.gz 199,2 MB cffa560f0820ffe2390ccb73c4def91bba8fa2d0c9244f6207e190cee3d2287d Linux de 64 bits (Arm)
google-cloud-cli-455.0.0-linux-arm.tar.gz 117,1 MB ad6031ecc452b48aeb28ead5287d1b22a6bddf5950420759f8eb64c04d1d0556 Linux de 32 bits (x86)
google-cloud-cli-455.0.0-linux-x86.tar.gz 115,2 MB 271ac3c227a34c7290e7f0be8d8dde3378d91b7c7acf7a6f3687293221b37e9a 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-455.0.0-linux-x86_64.tar.gz
Consulte a tabela acima e substitua google-cloud-cli-455.0.0-linux-x86_64.tar.gz pelo nome do pacote
*.tar.gz
que se aplica à sua configuração. - 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-455.0.0-linux-x86_64.tar.gz
Opcional: para substituir uma instalação, remova o diretóriogoogle-cloud-sdk
existente e extraia o arquivo no mesmo local. - Adicione a CLI gcloud ao caminho. Execute o script de instalação 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. Para ver as flags disponíveis, execute:./google-cloud-sdk/install.sh --help
Opcional:- Para enviar estatísticas de uso anônimas
para melhorar a CLI gcloud, responda
Y
quando solicitado. -
Para adicionar a CLI gcloud ao
PATH
e ativar o preenchimento do comando, respondaY
quando solicitado.
- Para enviar estatísticas de uso anônimas
para melhorar a CLI gcloud, responda
- Abra um novo terminal para as alterações entrarem em vigor.
- Para inicializar a CLI gcloud, execute o comando
gcloud init
: - Opcional: instale outros componentes usando o gerenciador de componentes.
./google-cloud-sdk/bin/gcloud init
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 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 ocurl
instalados:sudo apt-get install apt-transport-https ca-certificates gnupg curl sudo
- Importe a chave pública do Google Cloud.
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 você não conseguir receber as atualizações mais recentes devido a uma chave expirada, consiga o arquivo de chave apt-get.gpg mais recente.
- 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
- Para distribuições mais recentes (Debian 9+ ou Ubuntu 18.04+), execute o seguinte comando:
- Atualize e instale a CLI gcloud:
sudo apt-get update && sudo apt-get install google-cloud-cli
Para mais opções deapt-get
, como desativação de prompts ou simulações, consulte as páginas de manual doapt-get
(em inglês).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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
Para imagens de base mais antigas que não são compatíveis com o comandogpg --dearmor
: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
- (Opcional) Instale um destes
outros componentes:
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
- 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
Conteúdo do pacote
A CLI gcloud está disponível no formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, 8 e 9, Fedora 33 e 34 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.
- Atualize o DNF com informações de repositório da CLI gcloud.
Confira a lista de pacotes disponíveis.
O exemplo de comando a seguir é para uma instalação compatível com o Red Hat Enterprise Linux 9. Atualize as definiçõ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
-
Se você estiver instalando no Fedora 34 ou 35, instale o
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Instale a CLI gcloud.
sudo dnf install google-cloud-cli
- (Opcional) Instale um destes
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
- 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 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
-
Confirme se você tem uma versão compatível do Python:
-
Para verificar a versão atual do Python, execute
python3 -V
oupython -V
. As versões compatíveis são o Python de 3.8 a 3.11. - O script de instalação principal oferece a instalação do Python 3.11 do CPython.
- 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
.
-
Para verificar a versão atual do Python, execute
- Faça o download de uma das seguintes opções:
-
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, remova o diretório
google-cloud-sdk
existente e extraia o arquivo no mesmo local. -
(Opcional) Use o script de instalação para adicionar ferramentas da CLI gcloud ao
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.11.Execute o script (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. -
Para inicializar a CLI gcloud, execute o comando
gcloud init
: - Opcional. Instale componentes extras usando o gerenciador de componentes.
Plataforma | Pacote | Tamanho | Soma de verificação SHA256 |
---|---|---|---|
macOS de 64 bits
(x86_64) |
google-cloud-cli-455.0.0-darwin-x86_64.tar.gz | 122,8 MB | 561db89e1eb9c84329fa267c7b60ea2eb31752bd90c399d316eb372903fb9fd9 |
macOS de 64 bits
(ARM64, Apple M1 silicon) |
google-cloud-cli-455.0.0-darwin-arm.tar.gz | 119,9 MB | c92972969d6f07e312226fbc133546b5e679a7882a8e2063c1fcc67773eadb1f |
macOS de 32 bits
(x86) |
google-cloud-cli-455.0.0-darwin-x86.tar.gz | 121,5 MB | 44c2165dcfc7d2a5430bd2190444bf72c87f2ce3ddc2500a9cf69161f534bad6 |
./google-cloud-sdk/bin/gcloud init
-
A Google Cloud CLI funciona no Windows 8.1 e posterior e no Windows Server 2012 e posterior.
-
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
-
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. -
A CLI do Google Cloud requer Python. versões compatíveis são o Python de 3.8 a 3.10. 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. 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
.- 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.
- Se a instalação não for bem-sucedida devido ao comando
find
não ter sido reconhecido, verifique se sua variável de ambientePATH
está definida para incluir a pasta que contémfind
. 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:
- Usando a CLI gcloud com scripts ou integração/implantaçã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 ajuste para instalar a CLI gcloud.
- Para instalações interativas do Windows e 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, será possível usar
comandos no grupo de comandos
gcloud components
para gerenciar a instalação. Isso
inclui ver os componentes instalados, adicionar e remover componentes e
fazer upgrade para uma nova versão ou fazer downgrade para uma versão específica da
CLI gcloud.
Versões anteriores da CLI gcloud
Se você precisar de uma versão diferente da CLI gcloud, instale a atual usando as instruções que aparecem anteriormente nesta página e faça login. Depois de fazer login, você poderá fazer o download das versões anteriores. Para ver as versões classificadas por data, ative Classificar e filtrar e clique na coluna Created.
Versões compatíveis do Python
A Google Cloud CLI requer o Python 3.8 a 3.11. Para mais informações
sobre como escolher e configurar seu intérprete de Python, consulte
gcloud topic startup
.
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