Usar o instalador da CLI do Google Cloud

A CLI gcloud fornece um instalador para cada plataforma suportada e pode ser implementada de forma interativa ou não interativa.

Instalação interativa

O instalador permite-lhe transferir, instalar e configurar a versão mais recente da CLI Google Cloud num modo interativo. Quando executa o instalador, este transfere os componentes da CLI do Google Cloud e instala-os no sistema local. Também executa tarefas de configuração adicionais, como adicionar componentes da CLI gcloud ao seu PATH e ativar a conclusão de comandos na sua shell.

Linux e macOS
  1. Na linha de comandos, execute o seguinte comando:
    curl https://sdk.cloud.google.com | bash
  2. Quando lhe for pedido, escolha uma localização no seu sistema de ficheiros (normalmente, o diretório inicial) para criar o subdiretório google-cloud-sdk.
  3. Se quiser enviar estatísticas de utilização anónimas para ajudar a melhorar a CLI gcloud, responda Y quando lhe for pedido.
  4. Para adicionar ferramentas de linhas de comando da CLI gcloud ao seu PATH e ativar a conclusão de comandos, responda Y quando lhe for pedido.
  5. Reinicie a shell:
    exec -l $SHELL
  6. Para inicializar o ambiente da CLI Google Cloud, execute o comando gcloud init:
    gcloud init
Windows (instalador)
    A CLI do Google Cloud funciona no Windows 8.1 e posterior, e no 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://storage.s3nsapis.fr/cloud-sdk-release/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.

  3. A CLI gcloud requer o Python. As versões suportadas são o Python 3.9 a 3.13. 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.

  4. 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, iniciar a shell da CLI gcloud e configurar a CLI gcloud. Certifique-se de que deixa selecionadas as opções para iniciar a shell e configurar a instalação. O instalador inicia uma janela de terminal e executa o comando gcloud init.

  5. A instalação predefinida não inclui as extensões do App Engine necessárias para implementar uma aplicação através de comandos gcloud. Estes componentes podem ser instalados através do gestor de componentes da 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.
Windows (Zip)

Também pode instalar a versão mais recente a partir de um ficheiro .zip transferido:

  1. Transfira google-cloud-sdk.zip e extraia o respetivo conteúdo. (Clique com o botão direito do rato no ficheiro transferido e selecione Extrair tudo.)

  2. Inicie o script google-cloud-sdk\install.bat e siga as instruções de instalação.

  3. Quando a instalação terminar, reinicie a linha de comandos (cmd.exe).

  4. Corrida gcloud init:

    C:\> gcloud init

Implementação não interativa (silenciosa)

Pode automatizar a instalação da Google Cloud CLI através do script de instalação.

Para Linux e MacOS:

Guarde o script de instalação localmente em vez de o encaminhar para o bash.

  1. Introduza o seguinte numa linha de comandos:
    curl https://sdk.cloud.google.com > install.sh
  2. Execute o script, transmitindo os argumentos descritos da seguinte forma:
    bash install.sh --disable-prompts

As opções de install.sh são:

  • --disable-prompts: desativar comandos.
  • --install-dir=DIRECTORY: defina o diretório raiz de instalação para DIRECTORY. A CLI do Google Cloud está instalada em DIRECTORY/google-cloud-sdk. A predefinição é $HOME.

Para Windows:

  • /S: instalar silenciosamente. Não são apresentadas páginas do instalador. Use flags para alterar as definições de instalação.
  • /D - defina o diretório de instalação predefinido. Tem de ser o último parâmetro usado na linha de comandos e não pode conter aspas, mesmo que o caminho contenha espaços. Apenas são suportados caminhos absolutos, por exemplo, /D=C:\CloudSDK
  • /allusers: instalar para todos os utilizadores
  • /singleuser: instalar para o utilizador atual (predefinição)
  • /screenreader – ative o modo de leitor de ecrã (a predefinição é desativá-lo)
  • /reporting - Ative os relatórios de utilização (a predefinição é desativar os relatórios de utilização)
  • /noreporting: desativar relatórios de utilização (a predefinição é desativar os relatórios de utilização)
  • /nostartmenu - não criar atalho do menu Iniciar (a predefinição é criar o atalho)
  • /nodesktop - não criar atalho no ambiente de trabalho (a predefinição é criar um atalho)