Instalar a CLI do Google Cloud
Neste guia de início rápido, mostramos como instalar e inicializar a Google Cloud CLI e executar alguns comandos principais da CLI gcloud.
Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientações:
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.
Como instalar a versão mais recente da CLI gcloud (505.0.0)
- Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer
o Python de 3.8 a 3.13. 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-linux-x86_64.tar.gz 132.4 MB 3f964929afb8802b116114453a63ef91bfe87e304370d8d96ca1a93602d4c277 Linux de 64 bits (Arm)
google-cloud-cli-linux-arm.tar.gz 54,6 MB 62ca4a59e09740d9dfd5bc89cd7ff7895b1925fddc7c6b0f9a355f36efd6e027 Linux de 32 bits (x86)
google-cloud-cli-linux-x86.tar.gz 54,6 MB 809a5600ab2917a68506faf5291437b10f4d0d4040962edf307737fcee4241ae 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. - Para extrair o conteúdo do arquivo para o sistema de arquivos (preferencialmente para
seu diretório inicial), execute o seguinte comando:
Opcional: para substituir uma instalação, remova o diretóriotar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdk
e extraia o arquivo para o mesmo local. - (Opcional) Adicione a CLI gcloud ao
PATH
. Também é possível ativar a conclusão do comando para o 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: 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
./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, respondaY
quando solicitado.
- (Opcional) Para enviar estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud, responda
- Se você atualizou o
PATH
na etapa anterior, abra um novo terminal para que as mudanças entrem em vigor. - Para inicializar a CLI gcloud, execute o comando
gcloud init
: - Opcional: instale componentes extras 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
- 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 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.
- 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 gcloud CLI:
Para mais opções desudo apt-get update && sudo apt-get install google-cloud-cli
apt-get
, como desativar prompts ou simulações, consulte asapt-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:
Para imagens de base mais antigas que não são compatíveis com o comandoRUN 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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
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
- (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
- 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 no 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 gcloud CLI.
O comando de exemplo a seguir é para uma instalação compatível com o Red Hat Enterprise Linux 9, mas certifique-se de atualizar 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 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
- 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
-
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 3.8 a 3.13. - 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 um dos seguintes itens:
-
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
e extraia o arquivo para o mesmo local. - 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 solicitar a instalação do Python 3.11 e de alguns módulos recomendados.
A instalação também pode ser feita de maneira não interativa (por exemplo, usando um script) fornecendo preferências como flags. Para descrever as sinalizações disponíveis, execute: Para executar o script de instalação com o modo de leitor de tela ativado:./google-cloud-sdk/install.sh --help
Opcional:./google-cloud-sdk/install.sh --screen-reader=true
- (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, respondaY
quando solicitado.
- (Opcional) Para enviar estatísticas de uso anônimas para ajudar a melhorar a gcloud CLI, responda
- Se você atualizou o
PATH
na etapa anterior, abra um novo terminal para que as mudanças entrem em vigor. -
Para inicializar a CLI gcloud, execute
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-darwin-x86_64.tar.gz | 54,7 MB | 7754432976beaec18fbc3d66f907023e5a98be9cba3379d52e58b3a9d5520b03 |
macOS de 64 bits
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 54,6 MB | 736d81ad09baf325b4fd6ad95be4caa8fc19fe378ce6674819ff0f23058ebd70 |
macOS de 32 bits
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 53,3 MB | 6e1f750fc7f06a2f745a24296a7c0dba928cb08b35a74dda259d29bd9deee647 |
./google-cloud-sdk/bin/gcloud init
-
A Google Cloud CLI funciona no Windows 8.1 e versões mais recentes e no Windows Server 2012 e versões mais recentes.
-
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
-
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 Google Cloud CLI requer Python. As versões compatíveis são o Python 3.8 a 3.13. 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.
- Ative o recurso do Linux no Chromebook. A instalação da Google Cloud CLI no Chromebook requer esse recurso.
- Adicione o URI de distribuição da CLI gcloud como uma origem de 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
- 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 -
- Atualize e instale a CLI gcloud:
sudo apt-get update && sudo apt-get install google-cloud-cli
- (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
- 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
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.
Como inicializar a CLI gcloud
Use o comando gcloud init
para executar várias
tarefas comuns de configuração da CLI gcloud. Entre elas, autorizar a
CLI gcloud a acessar Google Cloud usando as credenciais da sua conta de usuário
e definir a configuração padrão.
Inicialize a CLI gcloud.
gcloud init
Aceite a opção de fazer login com sua conta de usuário do Google:
To continue, you must log in. Would you like to log in (Y/n)? Y
No navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir o acesso aos recursos do Google Cloud .
No prompt de comando, selecione um projeto do Google Cloud na lista de projetos em que você tem as permissões de proprietário, editor ou visualizador:
Pick cloud project to use: [1] [my-project-1] [2] [my-project-2] ... Please enter your numeric choice:
Se você tiver apenas um projeto,
gcloud init
o selecionará para você.Se você tiver acesso a mais de 200 projetos, precisará inserir um ID do projeto, criar um novo projeto ou listar projetos.
This account has a lot of projects! Listing them all can take a while. [1] Enter a project ID [2] Create a new project [3] List projects Please enter your numeric choice:
Se a API Compute Engine estiver ativada,
gcloud init
permitirá que você escolha uma zona padrão do Compute Engine:Which compute zone would you like to use as project default? [1] [asia-east1-a] [2] [asia-east1-b] ... [14] Do not use default zone Please enter your numeric choice:
gcloud init
confirma que você concluiu as etapas de configuração corretamente:Run `gcloud help config` to learn how to change individual settings This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects. Run `gcloud topic configurations` to learn more. Some things to try next: * Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command. * Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting * Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.
(Opcional) Para melhorar a experiência do leitor de tela, ative a propriedade
accessibility/screen_reader
:gcloud config set accessibility/screen_reader true
Para mais detalhes sobre os recursos de acessibilidade que vêm com a CLI gcloud, consulte o guia Como ativar recursos de acessibilidade.
Como executar comandos principais
Execute os comandos principais para conferir informações sobre a instalação da CLI gcloud:
Liste as contas com credenciais armazenadas no sistema local:
gcloud auth list
A CLI gcloud mostra uma lista de contas credenciadas:
Credentialed Accounts ACTIVE ACCOUNT * example-user-1@gmail.com example-user-2@gmail.com
Liste as propriedades na configuração ativa da gcloud CLI:
gcloud config list
A CLI gcloud mostra a lista de propriedades:
[core] account = example-user-1@gmail.com disable_usage_reporting = False project = example-project
Saiba mais sobre a instalação da CLI gcloud e a configuração ativa:
gcloud info
A CLI gcloud mostra um resumo das informações sobre a instalação. Isso inclui informações sobre o sistema, os componentes instalados, a conta de usuário ativa, o projeto atual e as propriedades da configuração ativa.
Confira informações sobre os comandos
gcloud
e outros tópicos:gcloud help
Por exemplo, para visualizar a ajuda para
gcloud compute instances create
:gcloud help compute instances create
A CLI gcloud mostra um tópico de ajuda que contém uma descrição do comando, uma lista de flags e argumentos de comando e exemplos de como usá-lo.
Limpar
Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
A seguir
- Leia o guia da CLI gcloud para uma visão geral da CLI gcloud, incluindo uma rápida introdução aos principais conceitos, convenções de comando e dicas úteis.
- Leia o guia de referência da gcloud CLI para páginas detalhadas sobre cada comando da CLI gcloud, incluindo descrições, flags e exemplos que podem ser usados para executar diversas tarefas no Google Cloud.
- Consulte a folha de referência da CLI gcloud para conferir uma lista de comandos e conceitos-chave mais usados.
- Instale outros componentes, como os emuladores do App Engine ou
kubectl
, usando o gerenciador de componentes da CLI gcloud.