Instalar a CLI do Google Cloud

Antes de seguir as instruções deste guia, leia Configurar a Google Cloud CLI para o Cloud de Confiance.

Neste guia de início rápido, descrevemos o método recomendado para instalar e inicializar a Google Cloud CLI. Após a inicialização, execute alguns comandos principais da CLI gcloud para ver informações sobre a instalação e verificar se ela foi bem-sucedida.

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.

Instalar a versão 590.0.0 da CLI gcloud

Linux
  1. Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python de 3.10 a 3.15. 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 a documentação do gcloud topic startup.
  2. Faça o download de um dos seguintes itens:
    Plataforma Nome do pacote Tamanho Checksum SHA256
    Linux de 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 94,0 MB 351ed4a2812c5525c1cee00334257a42c020fcaffa27d3067c1eec0a618dd83f
    Linux de 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 54,4 MB dc3ad610faefe6f9d2e4472affe1db71836315f43ab3a3747221eb7595b431cb
    Linux de 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 54,4 MB 704d32be816d1aef1250721e52fc2d9e0802eab6eac513aef97db4c7ace19b2b

    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.

  3. Para extrair o conteúdo do arquivo para o sistema de arquivos, execute o seguinte comando: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Para substituir uma instalação, exclua o diretório google-cloud-sdk e extraia o arquivo para o mesmo local.
  4. Execute o script de instalação na raiz da pasta extraída: 
    ./google-cloud-sdk/install.sh
     O script solicita que você execute as seguintes ações de configuração. Para aceitar, responda Y quando solicitado.
    • Adicione a CLI gcloud ao PATH.
    • Ative o preenchimento de comandos.
    • Ative o envio de estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud.
    Também é possível realizar a instalação de maneira não interativa fornecendo flags. Para ver as flags disponíveis, execute: 
    ./google-cloud-sdk/install.sh --help
  5. Opcional: se você atualizou o PATH na etapa anterior, abra um novo terminal para que as alterações entrem em vigor.
macOS
  1. Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python de 3.10 a 3.15.

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

    O instalador da gcloud vai instalar o Python v3.14 e os módulos de extensão necessários por padrão.

    Para mais informações sobre como configurar o interpretador do Python, consulte a documentação do gcloud topic startup.

  2. Faça o download de um dos seguintes itens:
    Plataforma Pacote Tamanho Checksum SHA256
    macOS de 64 bits

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 54,5 MB 9ff4e7c7fa49eca2e61af3d6ba31735ed08f90e5fae503d19d4c1c520f818736
    macOS de 64 bits

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 54,4 MB b1f80ffe9cc970ff1935b4adfddd0fb89d7e7b3341a88d70216d4283211b8d2d
    macOS de 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 52,9 MB b2da028700b7af4ebc2364fc59398921a3c2d67f91fe63d3a7a42648a54eb6ab

    Como alternativa, é possível baixar o arquivo na linha de comando. 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 arquivo para o local de sua preferência no sistema de arquivos. Uma prática comum é extraí-lo para o diretório inicial.

    No macOS, isso pode ser feito abrindo o arquivo .tar.gz salvo no local de preferência. Como alternativa, na linha de comando, execute: 

    tar -xf FILE_NAME

    Para substituir uma instalação, exclua o diretório google-cloud-sdk e extraia o arquivo para o mesmo local.

  4. Execute o script de instalação na raiz da pasta extraída: 
    ./google-cloud-sdk/install.sh
     O script solicita que você execute as seguintes ações de configuração. Para aceitar, responda Y quando solicitado.
    • Instale o Python 3.14 e os módulos recomendados, se necessário.
    • Adicione a CLI gcloud ao PATH e ative o preenchimento de comandos.
    • Ative o envio de estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud.
    Também é possível realizar a instalação de maneira não interativa fornecendo flags. Para ver as flags 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
  5. Opcional: se você atualizou o PATH na etapa anterior, abra um novo terminal para que as alterações entrem em vigor.
Windows

A CLI do Google Cloud no Windows requer o Windows 8.1 e versões mais recentes ou o Windows Server 2012 e versões mais recentes.

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

  2. 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 ícones de carregamento unicode, mostrar 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.10 a 3.15. Por padrão, a versão para Windows da Google Cloud CLI vem com o Python 3. Para usar a Google Cloud CLI, 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 a 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.

  3. 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 e iniciar o shell da Google Cloud CLI. Desmarque a opção para iniciar o shell. Você vai executar e configurar a CLI gcloud nas próximas etapas.

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.

Inicializar e autorizar a CLI gcloud

Se você estiver atrás de um proxy ou firewall, consulte Configuração de proxy para ativar o acesso à rede para a CLI gcloud.

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

  1. Execute gcloud init para inicializar a CLI gcloud:

    gcloud init

    Por padrão, esse comando abre um navegador da Web para autorizar o acesso. Para autorizar pela linha de comando, adicione a flag --console-only. Para autorização não interativa, crie uma conta de serviço com os escopos apropriados no console doCloud de Confiance e, em seguida, use gcloud auth activate-service-account com o arquivo de chave JSON.

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

    • Quando for solicitado, aceite e faça login na sua Conta do Google no navegador. Clique em Permitir para conceder permissão de acesso aos recursos.

    • Na lista de projetos em que você tem permissões de Proprietário, Editor ou Leitor, selecione um projeto. Se você tiver apenas um projeto, gcloud init o selecionará para você.

      Se você tiver mais de 200 projetos, será solicitado que insira um ID de projeto, crie um projeto ou liste projetos. Se você optar por criar um projeto, também será necessário ativar o faturamento nele.

    • Se a API Compute Engine estiver ativada, selecione uma zona padrão do Compute Engine.

  3. Opcional: para melhorar a experiência do leitor de tela, ative a propriedade accessibility/screen_reader com o seguinte comando:

    gcloud config set accessibility/screen_reader true

    Para mais informações, consulte o guia Como ativar recursos de acessibilidade.

Executar comandos principais

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

  1. Liste as contas com credenciais armazenadas no sistema local:

    gcloud auth list

    A CLI gcloud exibe uma lista de contas credenciadas:

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

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

    gcloud config list

    A CLI gcloud exibe 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 visualizar a ajuda para gcloud compute instances create:

    gcloud help compute instances create

    A CLI gcloud exibe 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 usar o comando.

Opcional: instalar outros componentes

Para instalar outros componentes, como os emuladores do App Engine, kubectl ou comandos da CLI gcloud no nível de lançamento Alfa ou Beta, consulte Como gerenciar componentes da CLI gcloud.

A seguir

  • Leia o guia da gcloud CLI para uma visão geral da CLI gcloud, incluindo uma introdução rápida aos principais conceitos, convenções de comando e dicas úteis.
  • Leia o guia de referência da gcloud CLI para ver páginas detalhadas sobre cada comando da CLI gcloud, incluindo descrições, flags e exemplos, que podem ser usados para realizar várias tarefas no Cloud de Confiance.
  • Consulte a folha de referência da CLI gcloud para ver uma lista de comandos e conceitos-chave usados com frequência.