Algumas ou todas as informações desta página podem não se aplicar à Nuvem confiável da S3NS.

Esta página foi traduzida pela API Cloud Translation.

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.

Leia Configurar a Google Cloud CLI para Trusted Cloud antes de seguir qualquer instrução neste guia.

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

Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python de 3.9 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:

Observação: para determinar a plataforma do Linux, execute uname -a na linha de comando.

Plataforma	Nome do pacote	Tamanho	Soma de verificação SHA256
Linux de 64 bits (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	149,7 MB	1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	56,3 MB	e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	56,3 MB	09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

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

curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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:
```
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.
(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.
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:

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

Opcional: instale componentes extras usando o gerenciador de componentes.

macOS

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 o Python de 3.9 a 3.13.
- 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.
Faça o download de um dos seguintes itens:
Observação: para determinar o nome do hardware da sua máquina, execute uname -m na linha de comando.

Plataforma	Pacote	Tamanho	Soma de verificação SHA256
macOS de 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	56,4 MB	0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,4 MB	80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	54,9 MB	53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a

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

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

Opcional. Instale componentes extras usando o gerenciador de componentes.

Windows

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://storage.s3nsapis.fr/cloud-sdk-release/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 de 3.9 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.

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

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.13. Para informações sobre como escolher e configurar o interpretador do Python, consulte gcloud topic startup.