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.

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

Antes de começar

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

Instalar a versão 577.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.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.
  2. Faça o download de um dos seguintes itens:
    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,5 MB 1c478abfe0fbe256b8ecaba2faeff154e44c308064b1c69d9ec15b879a4944bd
    Linux de 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61,3 MB ef8ded3afd45c89bc3900e32579bddfa406b44f7837d993adac417f00b41aa8f
    Linux de 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61,4 MB 52164ff332756c784df60ffcca7f6fd89c5465431b2019cbcd117631b76898c2

    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.

  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 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 maneira não interativa fornecendo flags. Para conferir 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 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 os 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

  1. Importe a chave pública Google Cloud .

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

  2. 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
  3. Atualize e instale a CLI gcloud: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Para mais opções de apt-get, como desativação de prompts ou simulações, consulte as páginas de manual de apt-get (em inglês).

    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