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.
When you finish the tasks that are described in this document, you can avoid continued billing by deleting the resources that you created. For more information, see Clean up.
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.