Documentação do Google Cloud SDK

O SDK do Google Cloud é um conjunto de ferramentas usadas para gerenciar recursos e aplicativos hospedados no Google Cloud Platform. Estes incluem as ferramentas de linha de comando gcloud, gsutil e bq. A ferramenta de linha de comando gcloud é transferida por download com o SDK do Cloud. Veja um guia abrangente sobre a CLI do gcloud em visão geral da ferramenta de linha de comando gcloud.

Além disso, a referência da CLI da gcloud documenta toda a funcionalidade da CLI do gcloud. Para uma introdução mais rápida, consulte a folha de referência da ferramenta de linha de comando gcloud.

Instalar a versão mais recente do SDK do Cloud (302.0.0)

Linux
  1. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.7 e 2.7.9 ou mais recentes.

    python2 --version
  2. Faça o download de um dos seguintes itens:
  3. Plataforma Pacote Tamanho Soma de verificação SHA256
    Linux de 64 bits

    (x86_64)

    google-cloud-sdk-302.0.0-linux-x86_64.tar.gz 78,5 MB 59cfb58e52d93ef4a39d475f6c5c9c0f13ad229ea7f871a8be41e6a2c0a76e4b
    Linux de 32 bits

    (x86)

    google-cloud-sdk-302.0.0-linux-x86.tar.gz 76,8 MB f35e1973f9a02a1dee4bd3a9f925aed468e0f78324114bc492c21fb9457d51b5

  4. Extraia o conteúdo do arquivo em qualquer local no sistema. Se você quer substituir uma instalação atual, remova o diretório google-cloud-sdk atual e extraia o arquivo para o mesmo local.
  5. (Opcional) Use o script de instalação para adicionar ferramentas do Cloud SDK ao seu caminho. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso. Execute o script com o seguinte comando:
    ./google-cloud-sdk/install.sh
    
    Isso também pode ser feito de forma não interativa (por exemplo, com um script), fornecendo preferências como sinalizações. Eles são descritos em:
    ./google-cloud-sdk/install.sh --help
    
    Abra um novo terminal para as alterações entrarem em vigor.
  6. Execute gcloud init para inicializar o SDK:
  7. ./google-cloud-sdk/bin/gcloud init
    
  8. Opcional. Instale componentes adicionais usando o gerenciador de componentes.
Debian/Ubuntu

O SDK do Cloud está disponível em formato de pacote para instalação em sistemas Debian e Ubuntu. O pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl ou as extensões do App Engine necessárias para implantar um aplicativo usando os comandos gcloud. Se você quiser esses componentes, instale-os separadamente conforme descrito mais adiante nesta seção.

É possível instalar o SDK do Cloud com um pacote Debian/Ubuntu para todas as versões do Ubuntu (em inglês) oficiais que não atingiram o fim da vida útil e as versões do Debian estáveis (em inglês) a partir do Wheezy.

Observação: se você usa uma instância no Google Compute Engine, o SDK do Cloud está instalado por padrão. Ainda assim, é possível instalar o SDK do Cloud manualmente seguindo as instruções abaixo.

  1. Inclua o URI da distribuição do SDK do Cloud como a origem do 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
    Observação: verifique se apt-transport-https (em inglês) está instalado:
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. 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 -
  3. Atualize e instale o SDK do Cloud:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Observação: para mais opções de apt-get, como desativação de prompts ou simulações, consulte as páginas de manual de apt-get (em inglês).
  4. Se preferir, instale qualquer um destes componentes extras:
    • 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, o componente google-cloud-sdk-app-engine-java pode ser instalado da seguinte maneira:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. Execute gcloud init para começar:
    gcloud init
Red Hat/Fedora/CentOS

O SDK do Cloud está disponível em formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 32 e CentOS 7. O pacote contém apenas os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele 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.

Observação: se você usa uma instância do Google Compute Engine, o Cloud SDK é instalado por padrão.

  1. Atualize o YUM com as informações de repositório do Cloud SDK:
    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=1
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    

    Importante: a segunda linha de gpgkey precisa ser recuada, conforme mostrado.

  2. Instale o Cloud SDK:
    yum install google-cloud-sdk
    Observação: para mais opções de yum, como desativação de prompts ou simulações, consulte as páginas de manual de yum (em inglês).
  3. Se preferir, instale qualquer um destes componentes extras:
    • 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, o componente google-cloud-sdk-app-engine-java pode ser instalado da seguinte maneira:

    yum install google-cloud-sdk-app-engine-java
  4. Execute gcloud init para começar:
    gcloud init
macOS
  1. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.7 e 2.7.9 ou mais recentes. As versões modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud.
  2. python -V
    
  3. Faça o download de um dos seguintes itens:
  4. Plataforma Pacote Tamanho Soma de verificação SHA256
    macOS de 64 bits

    (x86_64)

    google-cloud-sdk-302.0.0-darwin-x86_64.tar.gz 78,9 MB c0c97641e98179289f5eba1bdbfd019d3617bc33788857dc24df0106bdae2954
    macOS de 32 bits

    (x86)

    google-cloud-sdk-302.0.0-darwin-x86.tar.gz 77,9 MB b6a51f2fd463fa17a6bdd3e333abed84bbb030908c45ecc85533c6c6993cfaaf

  5. Extraia o conteúdo do arquivo em qualquer local no sistema. Se você quer substituir uma instalação atual, remova o diretório google-cloud-sdk atual e extraia o arquivo para o mesmo local.
  6. (Opcional) Use o script de instalação para adicionar ferramentas do Cloud SDK ao seu caminho. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso. Execute o script com o seguinte comando:
    ./google-cloud-sdk/install.sh
    
    Isso também pode ser feito de forma não interativa (por exemplo, com um script), fornecendo preferências como sinalizações. Eles são descritos em:
    ./google-cloud-sdk/install.sh --help
    
    Abra um novo terminal para as alterações entrarem em vigor.
  7. Execute gcloud init para inicializar o SDK:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. Opcional. Instale componentes adicionais usando o gerenciador de componentes.
Windows
  1. Faça o download do Instalador do SDK do Cloud.

    Se preferir, abra um terminal do PowerShell e execute os comandos a seguir:

    (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 é assinado pela Google LLC.

    O SDK do Cloud requer o Python. As versões compatíveis são 3.5 a 3.7 e 2.7.9 ou mais recentes.

    O instalador implantará todas as dependências necessárias, incluindo a versão necessária do Python. Embora o SDK do Cloud use atualmente o Python 2 por padrão, é possível usar uma instalação atual do Python ao desmarcar a opção "Instalar Bundled Python", se necessário. .

  3. Depois que a instalação for concluída, aceite as seguintes opções:

    • Iniciar o Shell do SDK do Cloud
    • Executar gcloud init

    O instalador inicia uma janela de terminal e executa o comando gcloud init.

  4. 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 do SDK do Cloud.

Instalar as bibliotecas de cliente mais recentes do Google Cloud

É possível fazer o download das Bibliotecas de cliente do Cloud para as linguagens compatíveis.

Opcional: ativar recursos de acessibilidade

Para uma experiência de leitor de tela mais otimizada, a ferramenta de linha de comando gcloud vem com uma propriedade accessibility/screen_reader.

Para ativar essa propriedade, execute:

gcloud config set accessibility/screen_reader true

Para mais detalhes sobre os recursos de acessibilidade que acompanham a ferramenta de linha de comando gcloud, consulte este guia.

Mais informações