Documentação do SDK do Google Cloud

O SDK do Google Cloud é um conjunto de ferramentas usadas para gerenciar recursos e aplicativos hospedados no Google Cloud Platform. Esses 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 da 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.

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

Linux

  1. O SDK do Cloud requer o Python. As versões compatíveis são 3.5 ou superiores e 2.7.9 ou superiores.

    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-280.0.0-linux-x86_64.tar.gz 56,3 MB 11950f1db216ec7dc3abaf80722fb80518c38e279bd76b6924326fe660c209cf
    Linux de 32 bits

    (x86)

    		 google-cloud-sdk-280.0.0-linux-x86.tar.gz 54,5 MB dfc2bc5d016e1c20d43c7bcd2f5be3063c31b924971598838978fbe25d6ac341

  3. 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.
  4. (Opcional) Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu caminho. Também é possível usar a conclusão do comando no shell e a coleção de estatísticas de uso. Execute o script com o seguinte comando: 
        ./google-cloud-sdk/install.sh
    Abra um novo terminal para as alterações entrarem em vigor.
  5. Execute gcloud init para inicializar o SDK:
    6.     ./google-cloud-sdk/bin/gcloud init
  6. (Opcional) Instale componentes extras 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 oficiais que não atingiram o fim da vida útil e as versões do Debian estáveis a partir do Wheezy.

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

  1. Adicione o URI de 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/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 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 no Google Compute Engine, o SDK do Cloud é instalado por padrão.

  1. Atualize o YUM com as informações de repositório do SDK do Cloud:
        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 SDK do Cloud:
    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 ou superiores e 2.7.9 ou superiores. As versões modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud. 
    2.     python -V
  2. Faça o download de um dos seguintes itens:

    3. Plataforma Pacote Tamanho Soma de verificação SHA256
    macOS de 64 bits

    (x86_64)

    		 google-cloud-sdk-280.0.0-darwin-x86_64.tar.gz 49 MB c9554507bc217a503b42bef7dfa72179bae57ad7e4e696af4205c50b373d3576
    macOS de 32 bits

    (x86)

    		 google-cloud-sdk-280.0.0-darwin-x86.tar.gz 47,9 MB 50c80701e1307ccd8e78fba34d34cec446cf24ee0a7ef30cef260c72676c0980

  3. 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.
  4. (Opcional) Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu caminho. Também é possível usar a conclusão do comando no shell e a coleção de estatísticas de uso. Execute o script com o seguinte comando: 
        ./google-cloud-sdk/install.sh
    Abra um novo terminal para as alterações entrarem em vigor.
  5. Execute gcloud init para inicializar o SDK:
    6.     ./google-cloud-sdk/bin/gcloud init
  6. (Opcional) Instale componentes extras 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 ou superiores e 2.7.9 ou superiores.

    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 abre 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. Esses componentes podem ser instalados usando 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

schedule

Guias de início rápido

Instale e inicialize o SDK do Cloud.
description

Guias de instruções

Execute tarefas específicas.
code

APIs e referência

Referência da CLI da gcloud
class

Conceitos

Amplie seu conhecimento sobre o SDK do Cloud.
help

Suporte

Receba ajuda para problemas do SDK do Cloud.
library_books

Recursos

Preços, cotas, notas da versão e outros recursos
account_tree

Soluções

Guias de vários produtos, práticas recomendadas e muito mais