Como usar o instalador da CLI do Google Cloud

A CLI do Google Cloud fornece um instalador para cada plataforma compatível e pode ser implantada de forma interativa ou não interativa.

Instalação interativa

O instalador permite fazer o download, instalar e configurar a versão mais recente da CLI do Google Cloud em um modo interativo. Quando você executa o instalador, ele faz o download dos componentes da CLI do Google Cloud e os instala no sistema local. Ele também executa outras tarefas de configuração, como adicionar componentes da CLI gcloud ao PATH e ativar a conclusão do comando no shell.

Linux e macOS
  1. Na linha de comando, execute o seguinte:
    curl https://sdk.cloud.google.com | bash
  2. Quando solicitado, escolha um local no seu sistema de arquivos (geralmente o diretório principal) para criar o subdiretório google-cloud-sdk.
  3. Se você quiser enviar estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud, responda Y quando solicitado.
  4. Para adicionar ferramentas da linha de comando da CLI gcloud ao PATH e ativar a conclusão dos comandos, responda Y quando solicitado.
  5. Reinicie o shell:
    exec -l $SHELL
  6. Para inicializar o ambiente da CLI do Google Cloud, execute gcloud init:
    gcloud init
Windows (Instalador)
    A Google Cloud CLI funciona no Windows 8.1 e versões mais recentes e no Windows Server 2012 e versões mais recentes.
  1. Faça o download do Instalador da CLI do Google Cloud.

    Como alternativa, abra um terminal do PowerShell e execute os seguintes comandos:

    (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 os prompts. O instalador é assinado pela Google LLC.

    Se você estiver usando um leitor de tela, marque a caixa de seleção Ativar modo leitor de tela. Essa opção configura gcloud para usar rastreadores de status em vez de spinners unicode, exibir o progresso como uma porcentagem e nivelar tabelas. Para mais informações, consulte o Guia de recursos de acessibilidade.

  3. O SDK do Cloud requer o Python. As versões compatíveis são Python 3 (preferencial, 3.5 a 3.8) e Python 2 (2.7.9 ou superior). Por padrão, a versão do SDK do Cloud para Windows vem com o Python 3 e o Python 2. Para usar o SDK do Cloud, seu sistema operacional precisa ser capaz de executar uma versão compatível do Python.

    Desde 1o de janeiro de 2020, a comunidade do Python não atualiza mais, corrige bugs, patches ou problemas de segurança do Python 2. Recomendamos que você faça upgrade para o Python 3 assim que possível. Para mais informações, consulte Suporte ao Python 2 no Google Cloud.

    O instalador instala todas as dependências necessárias, incluindo a versão necessária do Python. Embora o SDK do Cloud instale e gerencie o Python 3 por padrão, é possível usar uma instalação atual do Python ao desmarcar a opção de instalar o Bundled Python, se necessário. Consulte gcloud topic startup para saber como usar uma instalação existente do Python.

  4. Depois que a instalação for concluída, o instalador oferecerá a opção de criar os atalhos do menu e da área de trabalho, iniciar o shell da CLI do Google Cloud e configurar a CLI gcloud. Deixe as opções para iniciar o shell e configurar a instalação selecionadas. O instalador inicia uma janela de terminal e executa o comando gcloud init.

  5. A instalação padrão não inclui as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud. Para instalar esses componentes, use o gerenciador de componentes da CLI gcloud.
Dicas de solução de problemas:
  • Se a instalação não for bem-sucedida devido ao comando find não ter sido reconhecido, verifique se sua variável de ambiente PATH está definida para incluir a pasta que contém find. Geralmente, isso é C:\WINDOWS\system32;.
  • Se você desinstalou a CLI gcloud, é necessário reinicializar o sistema antes de instalá-la novamente.
  • Se a descompactação falhar, execute o instalador como um administrador.
Windows (Zip)

Também é possível instalar a versão mais recente a partir de um arquivo .zip transferido por download:

  1. Faça o download do google-cloud-sdk.zip e extraia o conteúdo dele. Clique com o botão direito do mouse no arquivo 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 o prompt de comando (cmd.exe).

  4. Execute gcloud init:

    C:\> gcloud init

Implantação não interativa (silenciosa)

É possível automatizar a instalação da CLI do Google Cloud usando o script de instalação.

Para Linux e MacOS:

Salve o script de instalação localmente em vez de encaminhá-lo para o bash.

  1. Digite o seguinte comando no prompt:
    curl https://sdk.cloud.google.com > install.sh
  2. Execute o script, transmitindo os argumentos descritos da seguinte maneira:
    bash install.sh --disable-prompts
- `--disable-prompts` - disable prompts.
- `--install-dir=DIRECTORY` - set the installation root
directory to `DIRECTORY`. The Google Cloud CLI is
installed in `DIRECTORY/google-cloud-sdk`.
The default is $HOME.

Para Windows:

  • /S: instala silenciosamente. Nenhuma página do instalador é exibida. Use sinalizações para alterar as configurações de instalação
  • /D: define o diretório de instalação padrão. Precisa ser o último parâmetro usado na linha de comando e não pode incluir aspas, mesmo que o caminho contenha espaços. Somente caminhos absolutos são compatíveis. Por exemplo, /D=C:\CloudSDK.
  • /allusers: instala para todos os usuários
  • /singleuser: instala para o usuário atual (padrão)
  • /screenreader: ativa o modo de leitor de tela (o padrão é desativá-lo).
  • /reporting: ativa o relatório de uso (o padrão é desativar os relatórios de uso)
  • /noreporting: desativa o relatório de uso (o padrão é desativar os relatórios de uso)
  • /nostartmenu: não cria atalho do menu iniciar (o padrão é criar um atalho)
  • /nodesktop: não cria atalho na área de trabalho (o padrão é criar um atalho)

Faça um teste

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

Comece a usar gratuitamente