Algumas ou todas as informações nesta página podem não se aplicar à Trusted Cloud by S3NS. Consulte o artigo Diferenças em relação ao Google Cloud para mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

Instale a CLI Google Cloud

Este guia de início rápido explica como instalar e inicializar a CLI gcloud e executar alguns comandos principais da CLI gcloud.

Deve ler o artigo Configurar a CLI do Google Cloud para Trusted Cloud antes de seguir quaisquer instruções neste guia.

Antes de começar

In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
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.

Quando terminar as tarefas descritas neste documento, pode evitar a faturação contínua eliminando os recursos que criou. Para mais informações, consulte o artigo Limpe.

Instalar a versão mais recente da CLI gcloud (540.0.0)

Linux

Confirme que tem uma versão suportada do Python. A CLI do Google Cloud requer o Python 3.9 a 3.13. Tenha em atenção que o pacote Linux x86_64 inclui um intérprete Python integrado que é o preferido por predefinição. Para informações sobre como escolher e configurar o seu intérprete Python, consulte gcloud topic startup.

Transfira uma das seguintes opções:

Nota: para determinar a sua plataforma Linux, execute uname -a na linha de comandos.

Plataforma	Nome do pacote	Tamanho	Soma de verificação SHA256
Linux (64 bits) (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	150,3 MB	de44b49eac7d8b1f7371c9c6ecd91ea6c72ea5abae29486cbdb47947a7403279
Linux (64 bits) (Arm)	google-cloud-cli-linux-arm.tar.gz	56,9 MB	22d9a460ff0443b03ecdc73b3fbb20ac39d85db63838ab8c77fbc544d30ff635
Linux (32 bits) (x86)	google-cloud-cli-linux-x86.tar.gz	56,9 MB	ccae88e39b0f3d5093b50395f5e6aaeab6d8f2b9edc23c4bfa10a4ec2a4ee384

Para transferir o ficheiro de 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 ficheiro para o seu sistema de ficheiros (de preferência, para o diretório principal), execute o seguinte comando:
```
tar -xf google-cloud-cli-linux-x86_64.tar.gz
```
Opcional: para substituir uma instalação existente, remova o diretório google-cloud-sdk existente e, em seguida, extraia o arquivo para a mesma localização.
(Opcional) Adicione a CLI gcloud ao seu PATH. Também pode optar pela conclusão de comandos para a recolha de estatísticas de utilização e do shell. Execute o script de instalação (a partir da raiz da pasta que extraiu no último passo) através do seguinte comando:
```
./google-cloud-sdk/install.sh
```
Isto também pode ser feito de forma não interativa (por exemplo, através de um script) e fornecendo preferências como flags. Para ver as flags disponíveis, execute o seguinte comando:
```
./google-cloud-sdk/install.sh --help
```
- Para enviar estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud, responda Y quando lhe for pedido.
- Para adicionar a CLI gcloud ao seu PATH e ativar a conclusão de comandos, responda Y quando lhe for pedido.
Se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
Para inicializar a CLI gcloud, execute gcloud init:

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

Opcional: instale componentes adicionais através do gestor de componentes.

macOS

Confirme que tem uma versão suportada do Python:
- Para verificar a sua versão atual do Python, execute python3 -V ou python -V. As versões suportadas são Python 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 comandos do Xcode são necessárias para instalar o Python.
  - Verifique se as ferramentas de linha de comandos do Xcode estão instaladas executando: xcode-select -p.
  - Se as ferramentas de linha de comandos do Xcode não estiverem instaladas, instale-as executando: sudo xcode-select --install.
- Caso contrário, para instalar uma versão do Python suportada, visite a página Python Releases for macOS em Python.org.
- Se tiver vários intérpretes Python instalados no seu computador, defina a variável de ambiente CLOUDSDK_PYTHON no shell para apontar para o caminho do seu intérprete preferencial.
- Para mais informações sobre como escolher e configurar o seu intérprete Python, consulte gcloud topic startup.
Transfira uma das seguintes opções:
Nota: para determinar o nome do hardware da sua máquina, execute uname -m a partir de uma linha de comandos.

Plataforma	Pacote	Tamanho	Soma de verificação SHA256
macOS de 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	57,0 MB	eb2348efb70fa63bf1eca56f8926ca0abc16f60e819810ae86f4638e121d493a
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,9 MB	0acc6fea1b73fc8633728dd5480215ec5db13f5489a6d7700829295e4c82a349
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	55,5 MB	b580b371989e8375c6c457510e5d659915c67e7920c052e94d27eaf502553210

Extraia o arquivo para qualquer localização no seu sistema de ficheiros (de preferência, o diretório inicial). No macOS, isto pode ser feito abrindo o ficheiro de arquivo .tar.gz transferido na localização preferida. Em alternativa, execute o seguinte comando:
```
tar -xf google-cloud-cli-darwin-arm.tar.gz
```
Opcional: para substituir uma instalação existente, remova o diretório google-cloud-sdk existente e, em seguida, extraia o arquivo para a mesma localização.
Execute o script de instalação (a partir da raiz da pasta que extraiu no último passo) com o seguinte comando:
```
./google-cloud-sdk/install.sh
```
O script pede-lhe que instale o Python 3.12 e determinados módulos recomendados.
A instalação também pode ser feita de forma não interativa (por exemplo, através de um script) fornecendo preferências como flags. Para descrever as flags disponíveis, execute o seguinte comando:
```
./google-cloud-sdk/install.sh --help
```
Para executar o script de instalação com o modo de leitor de ecrã ativado:
```
./google-cloud-sdk/install.sh --screen-reader=true
```
Opcional:
- Para enviar estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud, responda Y quando lhe for pedido.
- Para adicionar a CLI gcloud ao seu PATH e ativar a conclusão de comandos, responda Y quando lhe for pedido.
Se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
Para inicializar a CLI gcloud, execute o comando gcloud init:

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

Opcional. Instale componentes adicionais através do gestor de componentes.

Windows

Transfira o instalador da CLI do Google Cloud.

Em alternativa, abra um terminal do PowerShell e execute os seguintes comandos do PowerShell:

(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 as instruções. O instalador está assinado pela Google LLC.

Se estiver a usar um leitor de ecrã, selecione a caixa de verificação Ativar modo de leitor de ecrã. Esta opção configura o gcloud para usar indicadores de estado em vez de ícones de carregamento Unicode, apresentar o progresso como uma percentagem e simplificar as tabelas. Para mais informações, consulte o guia de funcionalidades de acessibilidade.
A CLI gcloud requer o Python. As versões suportadas são o Python 3.9 a 3.13. Por predefinição, a versão do Windows da CLI do Google Cloud é fornecida com o Python 3. Para usar a Google Cloud CLI, o seu sistema operativo tem de conseguir executar uma versão suportada do Python.

O instalador instala todas as dependências necessárias, incluindo a versão do Python necessária. Embora a Google Cloud CLI instale e faça a gestão do Python 3 por predefinição, pode usar uma instalação do Python existente, se necessário, desmarcando a opção para instalar o Python integrado. Consulte gcloud topic startup para saber como usar uma instalação do Python existente.
Após a conclusão da instalação, o instalador dá-lhe a opção de criar atalhos no menu Iniciar e no ambiente de trabalho, iniciar a shell da CLI gcloud e configurar a CLI gcloud. Certifique-se de que deixa selecionadas as opções para iniciar a shell e configurar a instalação. O instalador inicia uma janela de terminal e executa o comando gcloud init.
A instalação predefinida não inclui as extensões do App Engine necessárias para implementar uma aplicação através de comandos gcloud. Estes componentes podem ser instalados através do gestor de componentes da CLI gcloud.

Sugestões de resolução de problemas:

Se a instalação não for bem-sucedida porque o comando find não é reconhecido, certifique-se de que a variável de ambiente PATH está definida para incluir a pasta que contém find. Normalmente, este valor é C:\WINDOWS\system32;.
Se desinstalou a CLI gcloud, tem de reiniciar o sistema antes de instalar novamente a CLI gcloud.
Se a descompressão falhar, execute o instalador como administrador.

Opcional: instale as bibliotecas cliente do Google Cloud mais recentes

Pode transferir as bibliotecas cliente do Google Cloud para os idiomas suportados.

Inicializar a CLI gcloud

Use o comando gcloud init para realizar várias tarefas de configuração comuns da CLI gcloud. Estas incluem a autorização da CLI gcloud para aceder ao Trusted Cloud com as credenciais da sua conta de utilizador e a configuração da predefinição.

Inicialize a CLI gcloud:
```
gcloud init
```
Nota: para impedir que o comando inicie um navegador de Internet, use gcloud init --console-only. Para autorizar sem um navegador de Internet e de forma não interativa, crie uma conta de serviço com os âmbitos adequados através da Trusted Cloud consola e use gcloud auth activate-service-account com o ficheiro de chave JSON correspondente.
Aceite a opção para iniciar sessão com a sua conta de utilizador Google:
```
To continue, you must log in. Would you like to log in (Y/n)? Y
```
No navegador, inicie sessão na sua conta de utilizador Google quando lhe for pedido e clique em Permitir para conceder autorização de acesso aos recursos Trusted Cloud .
Na linha de comandos, selecione um Trusted Cloud projeto da lista de projetos onde tem autorizaçõ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 tiver apenas um projeto, o gcloud init seleciona-o automaticamente.

Se tiver acesso a mais de 200 projetos, é-lhe pedido que introduza um ID do projeto, crie um novo projeto ou liste 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:
```
Nota: se optar por criar um projeto, também tem de ativar a faturação no projeto para usar os Trusted Cloud by S3NS serviços.

Se tiver a API Compute Engine ativada, o gcloud init permite-lhe escolher uma zona do Compute Engine predefinida:

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 concluiu os passos de configuração com êxito:

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 ecrã, ative a propriedade accessibility/screen_reader:
```
gcloud config set accessibility/screen_reader true
```
Para mais detalhes sobre as funcionalidades de acessibilidade incluídas na CLI gcloud, consulte o guia Ativar funcionalidades de acessibilidade.

Executar comandos principais

Execute comandos essenciais para ver informações sobre a instalação da CLI gcloud:

Apresente uma lista das contas cujas credenciais estão armazenadas no sistema local:

gcloud auth list

A CLI gcloud apresenta uma lista de contas com credenciais:

Credentialed Accounts
ACTIVE             ACCOUNT
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

Liste as propriedades na sua configuração ativa da CLI gcloud:

gcloud config list

A CLI gcloud apresenta a lista de propriedades:

[core]
account = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

Veja informações sobre a instalação da CLI gcloud e a configuração ativa:
```
gcloud info
```
A CLI gcloud apresenta um resumo das informações sobre a sua instalação. Isto inclui informações sobre o seu sistema, os componentes instalados, a conta de utilizador ativa e o projeto atual, e as propriedades na configuração ativa.
Veja informações sobre os comandos gcloud e outros tópicos:
```
gcloud help
```
Por exemplo, para ver a ajuda de gcloud compute instances create:
```
gcloud help compute instances create
```
A CLI gcloud apresenta um tópico de ajuda que contém uma descrição do comando, uma lista de argumentos e flags de comando, e exemplos de como usar o comando.

Limpar

Para evitar incorrer em cobranças na sua Trusted Cloud conta pelos recursos usados nesta página, siga estes passos.

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.

O que se segue?

Leia o guia da CLI gcloud para ver uma vista geral da CLI gcloud, incluindo uma introdução rápida aos principais conceitos, convenções de comandos e dicas úteis.
Leia o guia de referência da CLI gcloud para ver páginas detalhadas sobre cada comando da CLI gcloud, incluindo descrições, flags e exemplos que pode usar para realizar várias tarefas no Trusted Cloud.
Consulte a referência rápida da CLI gcloud para ver uma lista de comandos usados frequentemente e conceitos importantes.
Instale componentes adicionais, como os emuladores do App Engine ou kubectl, através do gestor de componentes da CLI gcloud.