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:

Visita guiada


Antes de começar

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

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

    Linux
    1. 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 startup documentação.
    2. 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.gz que se aplica à sua configuração.

    3. Para extrair o conteúdo do ficheiro para o seu sistema de ficheiros, execute o seguinte comando:
      tar -xf google-cloud-cli-linux-x86_64.tar.gz
      Para substituir uma instalação existente, elimine 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:
      ./google-cloud-sdk/install.sh
      O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda Y quando lhe for pedido. Também pode realizar a instalação de forma não interativa através de flags. Para ver as flags disponíveis, execute o seguinte comando:
      ./google-cloud-sdk/install.sh --help
    5. Opcional: se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
    Debian/Ubuntu

    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:

    • É 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, o ca-certificates, o gnupg e o curl instalados. Para instalar estes pacotes, execute o seguinte comando:
      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 obter 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
    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 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-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

    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

    Red Hat/Fedora/CentOS

    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

    1. 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 gpgkey atualizado:

        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
    2. Instale libxcrypt-compat.x86_64.
      sudo dnf install libxcrypt-compat.x86_64
    3. Instale a CLI gcloud:
      sudo dnf install google-cloud-cli
    4. Opcional: instale qualquer um dos seguintes componentes adicionais:
      • 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, para instalar o componente google-cloud-cli-app-engine-java, execute o seguinte comando:

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

    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.

    macOS
    1. 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 -V ou python -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.

    2. 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_NAME pelo nome do pacote da sua plataforma na tabela acima.

      curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
    3. 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.gz transferido 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-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:
      ./google-cloud-sdk/install.sh
      O script pede-lhe que execute as seguintes ações de configuração. Para aceitar, responda Y quando lhe for pedido.
      • Instale o Python 3.13 e os módulos recomendados, se necessário.
      • Adicione a CLI gcloud ao seu PATH e ative a conclusão de comandos.
      • Ative o envio de estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud.
      Também pode realizar a instalação de forma não interativa através de flags. Para ver 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
    5. Opcional: se atualizou o PATH no passo anterior, abra um novo terminal para que as alterações tenham efeito.
    Windows

    A CLI Google Cloud no Windows requer o Windows 8.1 e posterior ou o 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.
      • 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 startup para saber como usar uma instalação do Python existente.
    3. 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.

    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.
    Chromebook
    1. Configure o ambiente de programação do Linux no Chromebook.
    2. 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
    3. 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 -
    4. Atualize e instale a CLI gcloud:
      sudo apt-get update && sudo apt-get install google-cloud-cli
    5. Opcional: instale qualquer um dos seguintes componentes adicionais:
      • 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, para instalar o componente google-cloud-cli-app-engine-java, execute o seguinte comando:

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

    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.

    1. Execute gcloud init para inicializar a CLI gcloud:

      gcloud init
      

      Por 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, use gcloud auth activate-service-account com o respetivo ficheiro de chave JSON.

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

    3. Opcional: para uma experiência melhorada do leitor de ecrã, ative a propriedade accessibility/screen_reader com o seguinte comando:

      gcloud config set accessibility/screen_reader true
      

      Para mais informações, consulte o guia Ativar funcionalidades de acessibilidade.

    Execute comandos básicos

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

    1. Apresentar as contas cujas credenciais estão armazenadas no sistema local:

      gcloud auth list
      

      A CLI gcloud apresenta uma lista de contas com credenciais:

      Credentialed Accounts
      ACTIVE             ACCOUNT
      *                  example-user-1@example.com
                         example-user-2@example.com
      

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

      gcloud config list
      

      A CLI gcloud apresenta a lista de propriedades:

      [core]
      account = example-user-1@example.com
      disable_usage_reporting = False
      project = example-project
      

    3. Veja informações sobre os comandos gcloud e outros tópicos:

      gcloud help
      

      Por exemplo, para ver a ajuda de gcloud compute instances create:

      gcloud help compute instances create
      

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

    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.

    O que se segue?

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