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

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

Antes de começar

In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Trusted 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 (533.0.0)

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,9 MB	0b95a9eed51924dc2b21137491d1bc62c334cb72aff269224bec2273cdc07387
Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	56,5 MB	b0a1b89d9a8cf0b3f1bd9383fcfdc24cb45639acbbcb3dc686b66737eacf0db2
Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	56,5 MB	52db4805a60f271b41821b51a835c171141a7bec1aa1882160c9ea26113dc963

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,6 MB	2a157b77b7cb68ba57910c068a7e4165c57d71721278c61c97581f4bd7582947
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,5 MB	888821363b551933a466f2db97de4a267fdf8d74c15924be0fae73790751ebf3
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	55,0 MB	15aea6c9f0d96b9499713c536e25c4c7cb81ef4ecf6fcfe05235f8d9fbd73f42

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.

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.

Inicializar a CLI gcloud

Use o comando gcloud init para executar várias tarefas comuns de configuração da CLI gcloud. Isso inclui autorizar a CLI gcloud a acessar Trusted Cloud usando as credenciais da sua conta de usuário e definir a configuração padrão.

Inicialize a CLI gcloud.
```
gcloud init
```
Observação :para impedir que o comando inicie um navegador da Web, use gcloud init --console-only. Para autorizar sem um navegador da Web e de forma não interativa, crie uma conta de serviço com os escopos apropriados usando o consoleTrusted Cloud e use gcloud auth activate-service-account com o arquivo de chave JSON correspondente.
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 seu navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir acesso aos recursos do Trusted Cloud .
No prompt de comando, selecione um projeto do Trusted Cloud na lista de projetos em que você tem permissões de proprietário, editor ou leitor:
```
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:
```
Observação: se você optar por criar um projeto, também será necessário ativar o faturamento no projeto para usar os serviços do Trusted Cloud by S3NS .

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 acompanham a CLI gcloud, consulte o guia Como ativar recursos de acessibilidade.

Como executar comandos principais

Execute 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 com uma descrição do comando, uma lista de flags e argumentos e exemplos de como usar o comando.

Limpar

Para evitar cobranças na conta do Trusted Cloud pelos recursos usados nesta página, siga as etapas abaixo.

Cuidado: excluir um projeto tem os seguintes efeitos:

Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

In the Trusted Cloud console, go to the Manage resources page.
Go to Manage resources
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 Trusted Cloud.
Consulte a folha de referência da CLI gcloud para ver uma lista de comandos e conceitos-chave mais usados.
Instale outros componentes, como emuladores do App Engine ou kubectl usando o gerenciador de componentes da CLI gcloud.