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. Instale a versão 552.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 203,3 MB c95e0277ba3792b83709aa43d8f95486de92b0a913d2393dbfca48f28b0bab39
      Linux (64 bits)

      (Arm)

      		 google-cloud-cli-linux-arm.tar.gz 58,1 MB a911104ae2b09392bfee61c79c128d5ad23e35bbfb792aadfe2a80024cece201
      Linux (32 bits)

      (x86)

      		 google-cloud-cli-linux-x86.tar.gz 58,1 MB e4ad30317c09cdc36dfc0c366034403e06d671ef5de2e6372bc01d7284b1a6a1

      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 apt-get opções adicionais, como desativar comandos ou testes de execução, consulte as apt-get páginas de manual.

      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