Instale a CLI gcloud

Esta página contém instruções para escolher e manter uma instalação da CLI Google Cloud. A CLI do Google Cloud inclui as ferramentas de linha de comandos gcloud, gsutil e bq. Para ver uma lista das funcionalidades da CLI gcloud, consulte Todas as funcionalidades.

Para aceder às APIs Google Cloud através de uma linguagem de programação suportada, pode transferir as bibliotecas cliente do Google Cloud.

Instruções de instalação

Estas instruções destinam-se à instalação da CLI Google Cloud. Para obter informações sobre a instalação de componentes adicionais, como comandos da CLI gcloud ao nível da versão alfa ou beta, consulte o artigo Gerir componentes da CLI gcloud.

Nota: se estiver a usar um proxy ou uma firewall, consulte a página de definições de proxy para mais informações sobre a instalação.

Linux

1. 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.
2. 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	128aaaf6ef1bcf9ca84d227202f92ab30e51c5ff5b1b44dfa4bcdd4b65f2ba46
   Linux (64 bits) (Arm)	google-cloud-cli-linux-arm.tar.gz	56,9 MB	c7c0ae1a4b9757eed63e7c96c99eefbb0be7c79b3614177fbb13980007bac22e
   Linux (32 bits) (x86)	google-cloud-cli-linux-x86.tar.gz	56,9 MB	159a757178daa9e1a53166ec62b70ff476cc15a18d4d9a36d3e60b8a850c9a52

   Para transferir o ficheiro de arquivo do Linux, execute o seguinte comando:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/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 (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.
4. (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.
5. Se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
6. Para inicializar a CLI gcloud, execute gcloud init:

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

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

Debian/Ubuntu

Nota: consoante a sua configuração, pode escolher outros métodos de instalação:

• Se quiser que o gcloud seja atualizado automaticamente para a versão mais recente e estiver a executar uma versão moderna do Ubuntu que use o Snap Package Manager, pode instalar a CLI Google Cloud como um pacote snap.
• Se estiver a usar uma instância no Compute Engine, a CLI gcloud é instalada por predefinição em várias imagens do SO. Consulte os detalhes do SO para ver uma lista completa.

Conteúdo da embalagem

A CLI gcloud está disponível no formato de pacote para instalação em sistemas Debian e Ubuntu. Este pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Não inclui kubectl nem as extensões do App Engine necessárias para implementar uma aplicação através de comandos gcloud. Se quiser estes componentes, tem de os instalar separadamente.

Antes de começar

Antes de instalar a CLI gcloud, certifique-se de que o seu sistema operativo cumpre os seguintes requisitos:

• É uma versão do Ubuntu que não atingiu o fim de vida ou uma versão estável do Debian que não atingiu o fim de vida
• Atualizou recentemente os respetivos pacotes:

  sudo apt-get update

• Tem apt-transport-https e curl instaladas:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Instalação

1. Importe a Google Cloud chave pública.

   • Para distribuições mais recentes (Debian 9 ou superior, ou Ubuntu 18.04 ou superior), execute o seguinte comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • Para distribuições mais antigas, execute o seguinte comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • Se o comando apt-key da sua distribuição não suportar o argumento --keyring, execute o seguinte comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • Se não conseguir receber as atualizações mais recentes devido a uma chave expirada, obtenha o ficheiro de chave apt-get.gpg mais recente.

2. Adicione o URI de distribuição da CLI gcloud como uma origem de pacotes.
   • Para distribuições mais recentes (Debian 9 ou superior, ou Ubuntu 18.04 ou superior), execute o seguinte comando:

     echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • Para distribuições mais antigas que não suportam a opção signed-by, execute o seguinte comando:

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Nota: certifique-se de que não tem entradas duplicadas para o repositório cloud-sdk em /etc/apt/sources.list.d/google-cloud-sdk.list.
3. Atualize e instale a CLI gcloud:

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Para opções apt-get adicionais, como desativar comandos ou testes de execução, consulte as páginas de manual apt-get.

   Sugestão do Docker: se estiver a instalar a CLI gcloud numa imagem do Docker, use um único passo RUN em alternativa:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   Para imagens base mais antigas que não suportam o comando gpg --dearmor:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

4. (Opcional) Instale qualquer um dos seguintes componentes adicionais:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Por exemplo, o componente google-cloud-cli-app-engine-java pode ser instalado da seguinte forma:

   sudo apt-get install google-cloud-cli-app-engine-java

5. Execute gcloud init para começar:

   gcloud init

Reduzir a versão da CLI gcloud

Para reverter para uma versão específica da CLI gcloud, em que VERSION tem o formato 123.0.0, execute o seguinte comando:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

As dez versões mais recentes estão sempre disponíveis no repositório.

NOTA: para lançamentos anteriores a 371.0.0, o nome do pacote é google-cloud-sdk

Red Hat/Fedora/CentOS

Nota: se estiver a usar uma instância no Compute Engine, a CLI Google Cloud é instalada por predefinição em várias imagens de SO. Consulte os detalhes do SO para ver uma lista completa.

Conteúdo da embalagem

A CLI gcloud está disponível no formato de pacote para instalação em sistemas Red Hat Enterprise Linux 7, 8 e 9; Fedora 41 e 42; e CentOS 7 e 8. Este pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Não inclui o kubectl nem as extensões do App Engine necessárias para implementar uma aplicação através de comandos gcloud, que podem ser instaladas separadamente, conforme descrito mais adiante nesta secção.

Instalação

1. Atualize o DNF com as informações do repositório da CLI gcloud. O comando de exemplo seguinte destina-se a uma instalação compatível com o Red Hat Enterprise Linux 9, mas certifique-se de que atualiza as definições conforme necessário para a sua configuração:

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM

2. Instale libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Instale a CLI gcloud:

   sudo dnf install google-cloud-cli

Nota: se não tiver mudado para dnf no seu sistema, pode executar estes comandos através de yum.

Também pode usar as opções dnf/yum, como desativar os comandos ou os testes, com os comandos fornecidos.

4. (Opcional) Instale qualquer um dos seguintes componentes adicionais:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Por exemplo, o componente google-cloud-cli-app-engine-java pode ser instalado da seguinte forma:

   sudo dnf install google-cloud-cli-app-engine-java

5. Execute gcloud init para começar:

   gcloud init

Reduzir a versão da CLI gcloud

Se quiser reverter para uma versão específica da CLI gcloud, em que VERSION tem o formato 123.0.0, execute o seguinte: sudo dnf downgrade google-cloud-cli-VERSION As dez versões mais recentes estão sempre disponíveis no repositório. NOTA: para lançamentos anteriores a 371.0.0, o nome do pacote é google-cloud-sdk

macOS

1. 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.
2. 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	56,9 MB	cc0f5d2f660889a399435a218bffebdb43d056b5d37a69142cf7dc2395c18f7d
macOS de 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,9 MB	4fa417f74a2e0a8839907e36d11e05731d8b4ba4445d300d2b7155060c0dcc8e
macOS de 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	55,4 MB	4af66400e2bbe20c05602c92cdde9e85c5f12818404e15aa4398b0bc580bc4ea

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

4. 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.
5. Se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
6. Para inicializar a CLI gcloud, execute o comando gcloud init:

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

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

Windows

A CLI Google Cloud funciona no Windows 8.1 e posterior, e no 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://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

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

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

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

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

Outras opções de instalação

Consoante as suas necessidades de desenvolvimento, em vez da instalação recomendada, pode usar um método alternativo de instalação da CLI gcloud:

• Está a usar a CLI gcloud com scripts ou integração/implementação contínua? Transfira um arquivo com versões para uma instalação não interativa de uma versão específica da CLI gcloud.
• Precisa de executar a CLI gcloud como uma imagem do Docker? Use a imagem do Docker da CLI gcloud para a versão mais recente (ou uma versão específica) da CLI gcloud.
• Está a usar o Ubuntu e prefere atualizações automáticas? Use um pacote snap para instalar a CLI gcloud.
• Para instalações interativas do Windows e macOS, e todos os outros exemplos de utilização, execute o instalador interativo para instalar a versão mais recente da CLI gcloud.

Faça a gestão de uma instalação

Depois de instalar a gcloud CLI, pode usar comandos no grupo de comandos gcloud components para gerir a sua instalação. Isto inclui a visualização dos componentes instalados, a adição e a remoção de componentes, bem como a atualização para uma nova versão ou a reposição de uma versão específica da CLI gcloud.

Por exemplo, pode usar o seguinte comando para atualizar a sua versão da gcloud CLI:

gcloud components update

Nota: se usou apt-get ou yum para instalar a CLI gcloud, tem de usar apt-get ou yum para atualizar ou remover componentes, e não gcloud components.

Versões anteriores da CLI gcloud

Se precisar de uma versão diferente da CLI gcloud, instale a versão atual através das instruções apresentadas anteriormente nesta página e, em seguida, inicie sessão. Depois de iniciar sessão, pode transferir lançamentos anteriores. Para ver as versões ordenadas por data, certifique-se de que ativa a opção Ordenar e filtrar e clique na coluna Criado.

Versões do Python compatíveis

A CLI do Google Cloud requer o Python 3.9 a 3.13. Para obter informações sobre como escolher e configurar o seu intérprete Python, consulte gcloud topic startup.

Experimente

Se for um novo utilizador do Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.

Comece gratuitamente