Instale a CLI Google Cloud
Este início rápido descreve o método recomendado para instalar e inicializar a CLI Google Cloud. Após a inicialização, execute alguns comandos principais da CLI gcloud para ver informações sobre a sua instalação e verificar se foi bem-sucedida.
Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google 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 role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google 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 role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- 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 startupdocumentação. - 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 202,9 MB 71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a Linux (64 bits) (Arm)
google-cloud-cli-linux-arm.tar.gz 57,7 MB 001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3 Linux (32 bits) (x86)
google-cloud-cli-linux-x86.tar.gz 57,8 MB 921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc 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.gzque se aplica à sua configuração. - Para extrair o conteúdo do ficheiro para o seu sistema de ficheiros, execute o seguinte comando:
Para substituir uma instalação existente, elimine o diretóriotar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdkexistente 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:
O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda./google-cloud-sdk/install.sh
Yquando 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.
./google-cloud-sdk/install.sh --help - Adicione a CLI gcloud ao seu
- Opcional: se atualizou o
PATHno passo anterior, abra um novo terminal para que as alterações tenham efeito. - É um lançamento do Ubuntu que não atingiu o fim de vida ou um lançamento estável do Debian que não atingiu o fim de vida.
- Atualizou recentemente os respetivos pacotes. Para o fazer agora, execute o seguinte comando:
sudo apt-get update
- Tem o
apt-transport-https, oca-certificates, ognupge ocurlinstalados. Para instalar estes pacotes, execute o seguinte comando:sudo apt-get install apt-transport-https ca-certificates gnupg curl
- 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 obter as atualizações mais recentes devido a uma chave expirada, obtenha o ficheiro de chave apt-get.gpg mais recente.
- 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
- Para distribuições mais recentes (Debian 9 ou superior, ou Ubuntu 18.04 ou superior), execute o seguinte comando:
- Atualize e instale a CLI gcloud:
Para opçõessudo apt-get update && sudo apt-get install google-cloud-cli
apt-getadicionais, como desativar comandos ou testes de execução, consulte as páginas de manualapt-get.Sugestão do Docker: se instalar a CLI gcloud numa imagem do Docker, use um único passo RUN em alternativa:
Para imagens base mais antigas que não suportam o comandoRUN 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
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
- Opcional: instale qualquer um dos seguintes
componentes adicionais:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
Por exemplo, o componente
google-cloud-cli-app-engine-javapode ser instalado da seguinte forma:sudo apt-get install google-cloud-cli-app-engine-java
- Atualize o DNF com as informações do repositório da CLI gcloud.
-
O seguinte comando de exemplo destina-se a instalações compatíveis com o Red Hat Enterprise Linux 7, 8 ou 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
-
Para instalações compatíveis com o RHEL 10, use o seguinte comando com o
gpgkeyatualizado: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-el10-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg EOM
-
-
Instale
libxcrypt-compat.x86_64.sudo dnf install libxcrypt-compat.x86_64
- Instale a CLI gcloud:
sudo dnf install google-cloud-cli
- Opcional: instale qualquer um dos seguintes
componentes adicionais:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
Por exemplo, para instalar o componente
google-cloud-cli-app-engine-java, execute o seguinte comando:sudo dnf install google-cloud-cli-app-engine-java
- 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 -Voupython -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. -
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 57,9 MB 6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8 macOS de 64 bits (ARM64, Apple silicon)
google-cloud-cli-darwin-arm.tar.gz 57,8 MB 36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339 macOS de 32 bits (x86)
google-cloud-cli-darwin-x86.tar.gz 56,3 MB eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56 Em alternativa, pode transferir o arquivo a partir da linha de comandos. Substitua
FILE_NAMEpelo nome do pacote da sua plataforma na tabela acima.curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
- 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.gztransferido 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-sdkexistente 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:
O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda./google-cloud-sdk/install.sh
Yquando lhe for pedido.- Instale o Python 3.13 e os módulos recomendados, se necessário.
- Adicione a CLI gcloud ao seu
PATHe ative a conclusão de comandos. - Ative o envio de estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud.
Para executar o script de instalação com o modo de leitor de ecrã ativado:./google-cloud-sdk/install.sh --help./google-cloud-sdk/install.sh --screen-reader=true
- Opcional: se atualizou o
PATHno passo anterior, abra um novo terminal para que as alterações tenham efeito. -
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
-
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
gcloudpara 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 startuppara saber como usar uma instalação do Python existente.
- 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
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 a shell. Nos passos seguintes, vai executar e configurar a CLI gcloud.
- Se a instalação não for bem-sucedida
porque o comando
findnão é reconhecido, certifique-se de que a variável de ambientePATHestá definida para incluir a pasta que contémfind. 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.
- Configure o ambiente de programação do Linux no Chromebook.
- Adicione o URI de distribuição da CLI gcloud como uma origem de pacotes. 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
- Importe a Google Cloud chave pública:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
- Atualize e instale a CLI gcloud:
sudo apt-get update && sudo apt-get install google-cloud-cli
- Opcional: instale qualquer um dos seguintes
componentes adicionais:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
Por exemplo, para instalar o componente
google-cloud-cli-app-engine-java, execute o seguinte comando:sudo apt-get install google-cloud-cli-app-engine-java
Execute
gcloud initpara inicializar a CLI gcloud:gcloud initPor 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 Google Cloud consola e, de seguida, usegcloud auth activate-service-accountcom o respetivo ficheiro de chave JSON.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 initseleciona-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.
Opcional: para uma experiência melhorada do leitor de ecrã, ative a propriedade
accessibility/screen_readercom o seguinte comando:gcloud config set accessibility/screen_reader truePara mais informações, consulte o guia Ativar funcionalidades de acessibilidade.
Apresentar as contas cujas credenciais estão armazenadas no sistema local:
gcloud auth listA CLI gcloud apresenta uma lista de contas com credenciais:
Credentialed Accounts ACTIVE ACCOUNT * example-user-1@example.com example-user-2@example.comListe as propriedades na sua configuração ativa da CLI gcloud:
gcloud config listA CLI gcloud apresenta a lista de propriedades:
[core] account = example-user-1@example.com disable_usage_reporting = False project = example-project
Veja informações sobre os comandos
gcloude outros tópicos:gcloud helpPor exemplo, para ver a ajuda de
gcloud compute instances create:gcloud help compute instances createA 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.
- 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 Google Cloud.
- Consulte a folha de consulta da CLI gcloud para ver uma lista de comandos usados frequentemente e conceitos importantes.
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 548.0.0 da CLI gcloud
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 as ferramentas de linhas de comando 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:
Instalação
Altere para versões anteriores 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. Para versões anteriores a 371.0.0,
o nome do pacote é google-cloud-sdk
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, 9 e 10; 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
Altere para versões anteriores da CLI gcloud
Para reverter para uma versão específica da CLI gcloud, execute o seguinte comando. Substitua
123.0.0 pela versão que quer instalar:
sudo dnf downgrade google-cloud-cli-123.0.0
As dez versões mais recentes estão disponíveis no repositório. Para versões anteriores à 371.0.0, use google-cloud-sdk como nome do pacote.
A CLI Google Cloud no Windows requer o Windows 8.1 e posterior ou o Windows Server 2012 e posterior.
Sugestões de resolução de problemas
Reduza as versões da CLI gcloud
Para reverter para uma versão específica da CLI gcloud, execute o seguinte comando. Substitua 123.0.0 pela versão que quer
instalar:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
As dez versões mais recentes estão disponíveis no repositório. Para lançamentos anteriores à versão 371.0.0, use google-cloud-sdk como nome do pacote.
Inicialize e autorize a CLI gcloud
Se estiver a usar um proxy ou uma firewall, consulte a 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 Google Cloud e configurar uma configuração predefinida. Para mais
informações, consulte gcloud init.
Execute comandos básicos
Execute comandos essenciais para ver informações sobre a instalação da CLI gcloud:
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
Gerir componentes da CLI gcloud.
Limpar
Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.