Instale a CLI do Google Cloud

Antes de começar

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance 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.

Instale a versão 549.0.1 da CLI gcloud

Linux

1. Confirme que tem uma versão suportada do Python. A CLI gcloud requer o Python 3.9 a 3.14. O pacote Linux x86_64 inclui um intérprete Python integrado que é preferido por predefinição. Para informações sobre como escolher e configurar o seu intérprete Python, consulte a gcloud topic startup documentação.
2. Transfira uma das seguintes opções:

   Plataforma	Nome do pacote	Tamanho	Soma de verificação SHA256
   Linux (64 bits) (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	203,0 MB	8a26504b012f9b92b94d149007ed55822d5f866425cd3838dbe85f46c102458c
   Linux (64 bits) (Arm)	google-cloud-cli-linux-arm.tar.gz	57,9 MB	019c831d690e3670843176b9acbe7bfa6cd9514a6de72510e84de9aecb768d9f
   Linux (32 bits) (x86)	google-cloud-cli-linux-x86.tar.gz	57,9 MB	55a68d549e95b9b5eda2c097cbee7e22828b2181bcba9d41692d47ac136b016e

   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.

3. Para extrair o conteúdo do ficheiro para o seu sistema de ficheiros, execute o seguinte comando:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Para substituir uma instalação existente, elimine o diretório google-cloud-sdk existente e, em seguida, extraia o arquivo para a mesma localização.
4. Execute o script de instalação a partir da raiz da pasta que extraiu:

   ./google-cloud-sdk/install.sh

   O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda Y quando lhe for pedido.
   • Adicione a CLI gcloud ao seu PATH.
   • Ative o preenchimento de comandos.
   • Ative o envio de estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud.
   Também pode realizar a instalação de forma não interativa através de flags. Para ver as flags disponíveis, execute o seguinte comando:

   ./google-cloud-sdk/install.sh --help

5. Opcional: se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.

macOS

1. Confirme que tem uma versão suportada do Python. A CLI gcloud requer o Python 3.9 a 3.14.

   Para verificar a versão do Python, execute python3 -V ou python -V.

   O script de instalação pode instalar o Python por si, se necessário. Isto requer as ferramentas de linha de comandos do Xcode. Para os instalar, execute sudo xcode-select --install. Em alternativa, pode instalar uma versão do Python suportada a partir de python.org.

   Para mais informações sobre a configuração do seu intérprete Python, especialmente se tiver várias versões instaladas, consulte a gcloud topic startupdocumentação.

2. Transfira uma das seguintes opções:

   Plataforma	Pacote	Tamanho	Soma de verificação SHA256
   macOS de 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	58,0 MB	ad200e25f088c5e10bcfe36d29169becb0fb5af5f920b03d64959173b5de07dd
   macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,9 MB	0201e3ef794da5c5e1f9dc84c5525f56147e4c273895df649b443c085794221d
   macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	56,4 MB	97842affe829f306731022a90607929acbfc66f7d9318676c2076fcd665d190b

   Em alternativa, pode transferir o arquivo a partir da linha de comandos. Substitua FILE_NAME pelo nome do pacote da sua plataforma na tabela acima.

   curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME

3. Extraia o conteúdo do ficheiro para a localização preferida no seu sistema de ficheiros. Uma prática comum é extraí-lo para o seu diretório inicial.

   No macOS, pode fazê-lo abrindo o ficheiro .tar.gz transferido na sua localização preferida. Em alternativa, na linha de comandos, execute:

   tar -xf FILE_NAME

   Para substituir uma instalação existente, elimine o diretório google-cloud-sdk existente e, em seguida, extraia o arquivo para a mesma localização.

4. Execute o script de instalação a partir da raiz da pasta que extraiu:

   ./google-cloud-sdk/install.sh

   O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda Y quando lhe for pedido.
   • Instale o Python 3.13 e os módulos recomendados, se necessário.
   • Adicione a CLI gcloud ao seu PATH e ative a conclusão de comandos.
   • Ative o envio de estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud.
   Também pode realizar a instalação de forma não interativa através de flags. Para ver 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

5. Opcional: se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.

Windows

A CLI Google Cloud no Windows requer o Windows 8.1 e posterior ou o Windows Server 2012 e posterior.

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

2. Inicie o instalador e siga as instruções. O instalador é 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.14. 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.

3. 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, e iniciar a shell da CLI gcloud. Desmarque a opção para iniciar o shell. Nos passos seguintes, vai executar e configurar a 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.

Inicialize e autorize a CLI gcloud

Se estiver a usar um proxy ou uma firewall, consulte a secção Configuração do proxy para ativar o acesso à rede para a CLI gcloud.

Depois de instalar a CLI gcloud, inicialize-a para autorizar o acesso a Cloud de Confiance e configurar uma configuração predefinida. Para mais informações, consulte gcloud init.

1. Execute gcloud init para inicializar a CLI gcloud:

   gcloud init
   

   Por predefinição, este comando abre um navegador de Internet para autorizar o acesso. Para autorizar a partir da linha de comandos, adicione a marca --console-only. Para a autorização não interativa, crie uma conta de serviço com os âmbitos adequados na Cloud de Confiance consola e, de seguida, use gcloud auth activate-service-account com o respetivo ficheiro de chave JSON.

2. Siga as instruções para autorizar e configurar:

   • Quando lhe for pedido para iniciar sessão, aceite e, em seguida, inicie sessão na sua Conta Google no navegador. Clique em Permitir para conceder autorização de acesso aos recursos.

   • Na lista de projetos para os quais tem autorizações de Proprietário, Editor ou Leitor, selecione um projeto. Se tiver apenas um projeto, gcloud init seleciona-o automaticamente.

     Se tiver mais de 200 projetos, é-lhe pedido que introduza um ID do projeto, crie um projeto ou liste projetos. Se optar por criar um projeto, também tem de ativar a faturação no mesmo.

   • Se tiver a API Compute Engine ativada, selecione uma zona do Compute Engine predefinida.

3. Opcional: para uma experiência melhorada do leitor de ecrã, ative a propriedade accessibility/screen_reader com o seguinte comando:

   gcloud config set accessibility/screen_reader true
   

   Para mais informações, consulte o guia Ativar funcionalidades de acessibilidade.

Execute comandos básicos

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

1. 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
   *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   

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

   gcloud config list
   

   A CLI gcloud apresenta a lista de propriedades:

   [core]
   account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   disable_usage_reporting = False
   project = my-project
   

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

Opcional: instale componentes adicionais

Para instalar componentes adicionais, como os emuladores do App Engine, kubectl, ou comandos da CLI gcloud ao nível de lançamento alfa ou beta, consulte o artigo Gerir componentes da CLI gcloud.

Limpar

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

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 uma variedade de tarefas no Cloud de Confiance.
• Consulte a folha de consulta da CLI gcloud para ver uma lista de comandos usados frequentemente e conceitos importantes.