O que é gcloud e como instalar no Windows, macOS e Linux?

Publicados: 2021-06-29

gcloud é a principal ferramenta CLI para trabalhar com recursos do Google Cloud.

O uso de ferramentas CLI oferece opções de automação com scripts fáceis de construir, o que de outra forma não seria possível se você dependesse exclusivamente da interface da web do provedor de nuvem apenas.

Com o gcloud CLI, você pode criar, modificar e excluir vários tipos de recursos do Google Cloud, como máquinas virtuais do Google Compute Engine, instâncias do Google Cloud SQL, clusters do Google Kubernetes Engine, Google Cloud DNS e Google Cloud Deployment Manager.

Além disso, ele pode ser usado para implantar aplicativos do App Engine, gerenciar autenticação para recursos de nuvem, personalizar a configuração de recursos e várias tarefas administrativas.

O Google Cloud oferece a opção de abrir um shell com gcloud CLI já disponível e configurado para usar com sua conta na nuvem.

gcloud-cloud-shell

Clique no ícone do shell no canto superior direito informando Ativar Cloud Shell para acessar gcloud CLI de um navegador da web. Isso abrirá uma janela de shell na parte inferior.

gcloud-cloud-shell-web

Mas se quiser usar o gcloud para gerenciar sua conta do Google Cloud diretamente de seu sistema, você deve instalá-lo primeiro. Neste artigo, abordaremos a instalação do gcloud CLI no Windows, macOS e Linux como parte da configuração do Google Cloud SDK.

janelas

Os binários de instalação do Windows estão disponíveis para configurar o gcloud SDK, que inclui o gcloud CLI. Você pode baixar o pacote mais recente do instalador do Cloud SDK aqui. Ou então você pode abrir um terminal PowerShell e inserir os comandos abaixo para baixar o instalador e iniciá-lo.

 (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe

Uma vez iniciado, siga o assistente na tela para concluir a instalação.

google-cloud-sdk-windows-installer

O Cloud SDK requer Python e as dependências são agrupadas com o instalador. Portanto, você pode usar as opções padrão em cada etapa do assistente de instalação, a menos que tenha um requisito específico para alterar os componentes de instalação ou localização, etc.

google-cloud-sdk-windows-installer-7

Você finalmente verá opções para criar atalhos úteis e inicializar o gcloud para configurá-lo para usá-lo com sua conta do Google Cloud. Basta seguir as instruções na tela, que abrirão uma tela de login usando o navegador padrão. Depois de fazer login, o shell solicitará que você selecione o projeto e a região padrão para usar com a CLI do gcloud. Quando estiver pronto, você pode executar comandos gcloud no prompt de comando do Windows.

google-cloud-sdk-windows

A instalação do SDK padrão não inclui alguns componentes extras, como extensões do App Engine, que você pode instalar separadamente usando o gerenciador de componentes do Cloud SDK. Os componentes incluídos por padrão no SDK são:

identificação Nome Descrição
gcloud Comandos CLI padrão do gcloud Ferramenta para interagir com o Google Cloud. Apenas os comandos nos níveis de liberação de disponibilidade geral e visualização são instalados com este componente. Você deve instalar separadamente os componentes gcloud alpha Commands e / ou gcloud beta Commands se quiser usar comandos em outros níveis de versão.
bq Ferramenta de linha de comando do BigQuery Ferramenta para trabalhar com dados no Google BigQuery
gsutil Ferramenta de linha de comando do Cloud Storage Ferramenta para realizar tarefas relacionadas ao Google Cloud Storage.
core Bibliotecas principais do Cloud SDK As bibliotecas são usadas internamente pelas ferramentas SDK.

Mac OS

O gcloud SDK requer Python para funcionar e deve ser instalado em seu macOS para que o gcloud CLI funcione.

O macOS moderno deve incluir a versão necessária do Python por padrão. Há uma opção de usar o Cloud SDK empacotado com Python 3 para instalar as dependências necessárias junto com gcloud CLI. Você pode verificar a versão do python em seu macOS abrindo um terminal e executando python -V

 $ python -V

Em seguida, execute uname -m e determine o hardware da máquina de seu sistema.

 $ uname -m

Com base na arquitetura da sua máquina, escolha o pacote certo para fazer o download. No momento em que este artigo foi escrito, a versão gcloud 346.x estava disponível.

Plataforma Pacote Tamanho SHA256 Checksum
macOS de 64 bits (x86_64) google-cloud-sdk-346.0.0-darwin-x86_64.tar.gz 86,5 MB 632164280208c050f015c9d04fa805c05478e80518a0fe667b413df55ab926ee
macOS de 64 bits (arm64) google-cloud-sdk-346.0.0-darwin-arm.tar.gz 86,4 MB 707948f45c8cc01012a92e3aff8af3701a89777bccdeec905310f70951c75bdb
macOS de 64 bits com Python empacotado (x86_64) google-cloud-sdk-346.0.0-darwin-x86_64-bundled-python.tar.gz 128,4 MB a31d67193ca21bf6943c275c633f3f5bf11c8526f47808f13a3c516df2e7aae3
macOS de 32 bits (x86) google-cloud-sdk-346.0.0-darwin-x86.tar.gz 90,3 MB 85493c0c5aba8fce9f8e7d1886bc0916db44bd0847cbf862cf87435fc8d729ff

Você pode então simplesmente extrair o arquivo TAR compactado para o local de sua preferência, provavelmente em algum lugar dentro do seu diretório pessoal. Para adicionar as ferramentas do Cloud SDK ao seu PATH e conclusão de comando para o seu shell, execute o script abaixo a partir da raiz do diretório extraído:

 $ ./google-cloud-sdk/install.sh

Continue para inicializar o SDK usando:

 $ ./google-cloud-sdk/bin/gcloud init

Componentes adicionais podem ser instalados para seu Cloud SDK usando o gerenciador de componentes.

RHEL / CentOS

Em um sistema baseado em RHEL / Fedora / CentOS, você pode instalar a partir dos repositórios yum do Google Cloud SDK.

Ele está disponível em formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33 e CentOS 7 e 8. Este pacote contém apenas os comandos gcloud , gcloud alpha , gcloud beta , gsutil e bq . Não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud , que podem ser instalados separadamente.

Para instalar usando o utilitário dnf , primeiro adicione o dnf do Cloud SDK executando a seguir em um terminal:

 $ sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-sdk] name=Google Cloud SDK baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM

Em seguida, instale o Cloud SDK usando:

 $ sudo dnf install google-cloud-sdk

Abaixo estão os componentes adicionais do Cloud SDK que podem ser instalados opcionalmente de acordo com a necessidade:

  • google-cloud-sdk-app-engine-python
  • google-cloud-sdk-app-engine-python-extras
  • google-cloud-sdk-app-engine-java
  • google-cloud-sdk-app-engine-go
  • google-cloud-sdk-bigtable-emulator
  • google-cloud-sdk-cbt
  • google-cloud-sdk-cloud-build-local
  • google-cloud-sdk-datalab
  • google-cloud-sdk-datastore-emulator
  • google-cloud-sdk-firestore-emulator
  • google-cloud-sdk-pubsub-emulator
  • kubectl

Por exemplo, para instalar google <span class="pun">-</span><span class="pln">cloud</span><span class="pun">-</span><span class="pln">sdk</span><span class="pun">-</span><span class="pln">app</span><span class="pun">-</span><span class="pln">engine</span><span class="pun">-</span> java , use:

 $ sudo dnf install google-cloud-sdk-app-engine-java

Para inicializar e configurar o gcloud com sua conta do Google Cloud, execute o comando abaixo e siga as instruções:

 $ gcloud init

Debian / Ubuntu

Da mesma forma, para sistemas baseados em Debian e Ubuntu, o Cloud SDK também está disponível em formato de pacote. Novamente, este pacote contém os comandos gcloud , gcloud alpha , gcloud beta , gsutil e bq apenas. Não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando comandos gcloud . Se você deseja esses componentes, deve instalá-los separadamente.

Como pré-requisito para as instalações do Debian / Ubuntu, certifique-se de que a versão do Ubuntu que você está usando não atingiu o fim de sua vida útil. Se você estiver no Debian, certifique-se de que está usando a versão estável do Debian a partir do Wheezy.

Para prosseguir com a instalação do Cloud SDK, primeiro, adicione o URI de distribuição como uma fonte de pacote:

 $ 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

Certifique-se de que você tenha os pacotes abaixo instalados:

 $ sudo apt-get install apt-transport-https ca-certificates gnupg

Importe a chave pública do Google Cloud:

 $ curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

Por fim, atualize e instale o Cloud SDK:

 $ sudo apt-get update && sudo apt-get install google-cloud-sdk

Qualquer um dos componentes abaixo pode ser instalado opcionalmente acima da configuração básica do Cloud SDK:

  • google-cloud-sdk-app-engine-python
  • google-cloud-sdk-app-engine-python-extras
  • google-cloud-sdk-app-engine-java
  • google-cloud-sdk-app-engine-go
  • google-cloud-sdk-bigtable-emulator
  • google-cloud-sdk-cbt
  • google-cloud-sdk-cloud-build-local
  • google-cloud-sdk-datalab
  • google-cloud-sdk-datastore-emulator
  • google-cloud-sdk-firestore-emulator
  • google-cloud-sdk-pubsub-emulator
  • kubectl

Para fazer isso, instale o componente necessário usando o comando apt-get abaixo:

 $ sudo apt-get install google-cloud-sdk-app-engine-java

Agora você está pronto para inicializar o gcloud usando:

 $ gcloud init

Siga as instruções na tela para conectar sua conta do Google Cloud e configurar as opções padrão.

Resumo

Como o AWS CLI, o Google Cloud oferece uma ferramenta CLI para gerenciar a infraestrutura do Google Cloud. Isso ajuda a fazer algumas tarefas repetitivas com mais rapidez e oferece uma oportunidade de escrever scripts e ferramentas de automação, abrindo caminho para a infraestrutura como código (IaC).

Para saber mais sobre a ferramenta Google Cloud CLI, ou seja, gcloud, consulte sua página de documentação e folha de dicas.