O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Instalar a CLI do Google Cloud

Este guia de início rápido descreve 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 conferir informações sobre a instalação e verificar se ela foi bem-sucedida.

Antes de começar

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 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 Google Cloud project.

Instalar a versão 586.0.0 da CLI gcloud

Linux

Confirme se você tem uma versão compatível do Python. A CLI do Google Cloud requer o Python de 3.10 a 3.14. 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.

Faça o download de um dos seguintes itens:

Observação:para determinar a plataforma do Linux, execute uname -a na linha de comando.

Plataforma	Nome do pacote	Tamanho	Soma de verificação SHA256
Linux de 64 bits (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	88,0 MB	c1cd1823624a33f2341d0d384aafe2d7b24c1b77c9b131087d772ee0791ff2be
Linux de 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	53,3 MB	67573751523f808db2a7dc9137d8df0faf91f78303e2c346f62ac2db4ae66f9f
Linux de 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	53,3 MB	76ae821a3a11b1b69a394c71c2ffe4d820a109f6acaec95a3f46b767a8a63bcc

Para fazer o download do 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.

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.
Execute o script de instalação na raiz da pasta extraída:
```
./google-cloud-sdk/install.sh
```
O script pede que você execute as seguintes ações de configuração. Para aceitar, responda Y quando solicitado.
- Adicione a CLI gcloud ao seu 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 fazer a instalação de forma não interativa fornecendo flags. Para conferir as flags disponíveis, execute:
```
./google-cloud-sdk/install.sh --help
```
Opcional: se você atualizou o PATH na etapa anterior, abra um novo terminal para que as mudanças entrem em vigor.

Debian/Ubuntu

Conteúdo do pacote

A CLI gcloud está disponível no formato de pacote para instalação em sistemas Debian e Ubuntu. O pacote contém apenas as ferramentas de linha de comando gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud. Se você quiser esses componentes, instale-os separadamente.

Antes de começar

Antes de instalar a CLI gcloud, verifique se o sistema operacional atende aos seguintes requisitos:

É uma versão do Ubuntu que não atingiu o fim da vida útil ou uma versão estável do Debian que não atingiu o fim da vida útil.
Recentemente, os pacotes foram atualizados. Para fazer isso agora, execute o seguinte comando:
```
sudo apt-get update
```
Ele tem ca-certificates, gnupg e curl instalados. Para instalar esses pacotes, execute o seguinte comando:
```
sudo apt-get install ca-certificates gnupg curl
```

Instalação

Importe a Google Cloud chave pública.
- Para distribuições mais recentes (Debian 9+ ou Ubuntu 18.04+), 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 for compatível com 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 for possível receber as atualizações mais recentes devido a uma chave expirada, consiga o arquivo de chave apt-get.gpg mais recente.
Adicione o URI de distribuição da CLI gcloud como uma origem de pacote.
- Para distribuições mais recentes (Debian 9+ ou Ubuntu 18.04+), 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 são compatíveis com a opção "assinado por", 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
```
Observação: verifique se não há entradas duplicadas para o repositório cloud-sdk em /etc/apt/sources.list.d/google-cloud-sdk.list.
Atualize e instale a CLI gcloud:
```
sudo apt-get update && sudo apt-get install google-cloud-cli
```
Observação:se você estiver instalando em máquinas virtuais, imagens de contêineres ou executores de CI/CD automatizados com recursos limitados, exporte a variável de ambiente CLOUDSDK_SKIP_PY_COMPILATION=1 durante a instalação para ignorar a compilação do Python no host. Isso reduz o tempo de instalação do pacote de minutos para segundos:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli
```
Definir essa variável ignora a compilação de bytes na instalação, trocando um pouco da velocidade de configuração do pacote por uma pequena sobrecarga de execução de comandos interativos.
Para mais opções de apt-get, como desativar prompts ou simulações, consulte as páginas de manual de apt-get.
Dica do Docker: se você estiver instalando a CLI gcloud dentro de uma imagem do Docker, use uma única etapa RUN:
```
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 de base mais antigas que não são compatíveis com 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 -
```