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. Nele você encontra 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.

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

Linux
  1. Verifique se seu sistema tem o Python 2 instalado na versão 2.7.9 ou mais recente. Você ainda pode ter outras versões do Python instaladas.

    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-245.0.0-linux-x86_64.tar.gz 27 MB bdc66eea38a78ae5b00c7caaa4848965ef63bce73d4374fc806f94ddfd34f10f
    Linux de 32 bits

    (x86)

    google-cloud-sdk-245.0.0-linux-x86.tar.gz 26,6 MB 3b836613d17d7f425464aaf231cf6163fd15cf353b40be47ad6a5fcc192c5183
  4. Extraia o conteúdo do arquivo em qualquer local no sistema. Para substituir uma instalação, remova o diretório google-cloud-sdk existente e extraia o arquivo no 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
    
    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 no formato de pacote para instalação em sistemas Debian e Ubuntu. Esse pacote contém somente os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl nem as extensões do App Engine necessárias para implantar um aplicativo usando os comandos do 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 do Google Compute Engine, o SDK do Cloud é instalado por padrão. Ainda é possível instalar o SDK do Cloud manualmente seguindo as instruções abaixo.

  1. Crie uma variável de ambiente para a distribuição correta:
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. Adicione o URI de distribuição do SDK do Cloud como a origem do pacote:
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    Observação: nesta etapa, caso tenha apt-transport-https instalado, use "https" em vez de "http".
  3. Importe a chave pública do Google Cloud:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    Dica de solução de problemas: caso não consiga receber as atualizações mais recentes devido a uma chave expirada, solicite o arquivo de chave apt-get.gpg mais recente.
  4. Atualize e instale o SDK do Cloud:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Observação: para outras opções do apt-get, como desativação de prompts ou simulações, consulte as páginas do manual do apt-get (em inglês).
  5. Se quiser, instale qualquer um destes componentes adicionais:
    • 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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-bigtable-emulator
    • kubectl

    Por exemplo, é possível instalar o componente google-cloud-sdk-app-engine-java da seguinte maneira:

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

O Cloud SDK está disponível no formato de pacote para instalação em sistemas Red Hat Enterprise Linux 7 e CentOS 7. Esse pacote contém somente os comandos gcloud, gcloud alpha, gcloud beta, gsutil e bq. Ele não inclui kubectl ou extensões do App Engine obrigatórias para a implantação de um aplicativo por meio de comandos do 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 outras opções do yum, como desativação de prompts ou simulações, consulte as páginas do manual do yum (em inglês).
  3. Se quiser, instale qualquer um destes componentes adicionais:
    • 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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Por exemplo, é possível instalar o componente google-cloud-sdk-app-engine-java da seguinte maneira:

    yum install google-cloud-sdk-app-engine-java
  4. Execute gcloud init para começar:
    gcloud init
macOS
  1. Versões modernas do macOS incluem a versão apropriada do Python para o SDK do Google Cloud. O SDK requer o Python 2 com um número de versão do Python 2.7.9 ou posterior. Quaisquer outros interpretadores do Python instalados não interferem na instalação do SDK do Google 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-245.0.0-darwin-x86_64.tar.gz 19,6 MB 78cbe75ebf17599217d4a6cb81897897faa72d6e5e0c515a8532c8827de59af7
    macOS de 32 bits

    (x86)

    google-cloud-sdk-245.0.0-darwin-x86.tar.gz 19,6 MB 3ca3575f19a21a589a75d2ed3c2a62af7d1be12482ad4cf3efba87e071977a61
  5. Extraia o conteúdo do arquivo em qualquer local no sistema. Para substituir uma instalação, remova o diretório google-cloud-sdk existente e extraia o arquivo no 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
    
    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. O instalador é assinado pela Google Inc.

  2. Inicie o instalador e siga as instruções.

    O SDK do Cloud requer o Python 2 com uma versão do Python 2.7.9 ou mais recente. O instalador instalará todas as dependências necessárias, incluindo a versão necessária do Python, por padrão. Se você já tem o Python 2.x.y instalado e quer usar a instalação existente, pode desmarcar a opção para instalar o Python do pacote.

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

    • Iniciar o Cloud SDK Shell
    • Executar gcloud init

  4. O instalador abre 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 os comandos do gcloud. Esses componentes podem ser instalados usando o gerenciador de componentes do SDK do Cloud.

Observação: nas instâncias do Google Compute Engine que executam o Windows Server, o Internet Explorer está na Configuração de segurança reforçada. Essa configuração impede que você execute o instalador mencionado acima. Primeiramente, desative a Configuração de Segurança Reforçada, reinicie o Internet Explorer e, em seguida, execute o instalador. Para ver instruções de como desativar a Segurança Reforçada na instância do Windows Server, abra a Ajuda e Suporte do Windows e procure por "IE ESC".

Como 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.

Mais informações

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK