Como instalar o Cloud SDK

Esta página apresenta as instruções de download e instalação do Google Cloud SDK.

Requisitos do sistema

O Cloud SDK é executado no Linux, Mac OS X e Windows e requer o Python 2.7.x. Algumas ferramentas integradas ao Cloud SDK têm requisitos adicionais. Por exemplo, as ferramentas Java para desenvolvimento do Google App Engine requerem o Java 1.7 ou posterior.

Opções de instalação

Siga um destes procedimentos para instalar o Cloud SDK:

  • Faça o download de um arquivo com controle de versão de qualquer versão, incluindo as anteriores.
  • Execute o instalador interativo para fazer o download e instalar a versão mais recente.
  • Use apt-get (somente Debian e Ubuntu) para fazer o download e instalar a versão mais recente.
  • Use yum (Red Hat e CentOS) para fazer o download e instalar a versão mais recente.

Esses métodos instalam os componentes padrão do Cloud SDK, que incluem as ferramentas de linha de comando gcloud, gsutil e bq. Para instalar outros componentes, use o comando gcloud components install ou instale os pacotes deb ou RPM apropriados.

Arquivos com controle de versão

O Cloud SDK dispõe de arquivos com controle de versão para download exclusivos da versão. Cada um desses arquivos inclui uma instalação autônoma do Cloud SDK em um diretório denominado google-cloud-sdk, que pode ser copiado para qualquer local no seu sistema de arquivos.

Eles foram criados para instalação não interativa de versões específicas do Cloud SDK e são úteis quando:

  • Você precisa de uma versão específica do Cloud SDK. Por exemplo:

    • Você usa scripts com o gcloud ou um dos outros componentes do Cloud SDK e quer verificar se os scripts não são interrompidos como resultado de uma atualização do Cloud SDK.
    • Você usa o Cloud SDK como parte de um processo de integração contínua (CI, na sigla em inglês) ou do sistema de produção no qual quer controlar as dependências para garantir a compatibilidade entre as partes do sistema.
    • Você executa implantações automatizadas do Cloud SDK em muitas máquinas, que precisam estar sincronizadas entre si.
    • Você está atrás de um proxy ou firewall que exige configuração adicional para poder acessar a Internet.
  • Você não quer executar uma instalação interativa.

Para instalar a versão mais recente do Cloud SDK de um arquivo com controle de versão:

  1. Faça o download de um dos seguintes itens:

    Plataforma Pacote Tamanho Soma de verificação SHA256
    Linux de 64 bits

    (x86_64)

    google-cloud-sdk-196.0.0-linux-x86_64.tar.gz 19,0 MB 4de5cc9b9e70cf08150cc7595a89a69efffee0f1e4c55dcb60c16601bfd5f0fc
    Linux de 32 bits

    (x86)

    google-cloud-sdk-196.0.0-linux-x86.tar.gz 18,6 MB 44f7bcc65e8e906307ff4d28b90492611d92f77e7fdb33bad71d16412b7fdfb9
    Mac OS X de 64 bits

    (x86_64)

    google-cloud-sdk-196.0.0-darwin-x86_64.tar.gz 15,1 MB 985ed75c67637041182425fe6669df66693de5ad89335d900903a7b8aa22bbe1
    Mac OS X de 32 bits

    (x86)

    google-cloud-sdk-196.0.0-darwin-x86.tar.gz 15,1 MB f90ea5d3b4f70961d3763ba1a9f96361ea370c31f650e8b5f5853c4cedcf4d17
    Windows de 64 bits

    (x86_64)

    google-cloud-sdk-196.0.0-windows-x86_64.zip 96,2 MB c23a13190d379ffdb7c56252bba22f2fcc7781080787339680d359edd2c4bda0
    Windows de 64 bits

    (x86_64) com Python integrado

    google-cloud-sdk-196.0.0-windows-x86_64-bundled-python.zip 134,5 MB dc3fab3e05535e9b16cac4895f80e05a0add858f819163580e77f777a4347d22
    Windows de 32 bits

    (x86)

    google-cloud-sdk-196.0.0-windows-x86.zip 96,3 MB ff4907947bdd9606a58923f8ddff7644e80747759138ff4843ab34bf7f5c8f4f
    Windows de 32 bits

    (x86) com Python integrado

    google-cloud-sdk-196.0.0-windows-x86-bundled-python.zip 130,7 MB 67dc25a82a1e658c0f774e7b0e6ff14357725978ff498b8cbd0dcb69c0085921

  2. Extraia o arquivo em qualquer local no sistema de arquivos.

  3. Opcional. Execute o script de instalação para adicionar ferramentas do Cloud SDK ao seu caminho. A execução desse script também gerará instruções para habilitar a conclusão do comando no seu shell bash (somente Linux e Mac OS) e ativar a geração de relatórios de uso.

    • No Linux ou Mac OS X:

      ./google-cloud-sdk/install.sh
      

      Para adicionar ferramentas de linha de comando do Cloud SDK ao seu PATH, você precisará fornecer o caminho /your/gcloud/filepath/path.bash.inc no seu perfil. Além disso, forneça o caminho /your/gcloud/filepath/completion.bash.inc no seu perfil para habilitar a conclusão do comando shell para o gcloud.

    • No Windows:

      .\google-cloud-sdk\install.bat
      

    Execute install.sh --help ou install.bat --help para ver uma lista das sinalizações que podem ser passadas para esse script.

  4. Execute gcloud init para inicializar o SDK:

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

Versões anteriores

As versões anteriores do Cloud SDK estão disponíveis no arquivo de download no Google Cloud Storage. Elas podem ser acessadas diretamente em https://storage.googleapis.com/cloud-sdk-release/<archive_name>.

Instalador interativo

O Cloud SDK também oferece um instalador interativo para cada plataforma compatível. O instalador permite fazer o download, instalar e configurar rapidamente a versão mais recente do Cloud SDK no modo interativo. Quando você executa o instalador, ele faz o download dos componentes do Cloud SDK e os instala no sistema local. Ele também executa outras tarefas de configuração, como adição de componentes do Cloud SDK ao PATH e ativação do preenchimento do comando no shell.

Linux
  1. Digite o seguinte comando no prompt:
    curl https://sdk.cloud.google.com | bash
  2. Reinicie o shell:
    exec -l $SHELL
  3. Execute gcloud init para inicializar o ambiente gcloud:
    gcloud init
Mac OS X
  1. Digite o seguinte comando no prompt:
    curl https://sdk.cloud.google.com | bash
  2. Reinicie o shell:
    exec -l $SHELL
  3. Execute gcloud init para inicializar o ambiente gcloud:
    gcloud init
Windows
  1. Faça o download do Instalador do Cloud SDK. O instalador é assinado pela Google Inc.

  2. Inicie o instalador e siga as instruções. Se você não tiver o Python 2 na versão 2.7.9 ou posterior instalado no seu sistema, verifique se a opção para instalar o Python integrado está marcada. No momento, o Cloud SDK não é compatível com o Python 3.

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

    • Iniciar o Cloud SDK Shell
    • Executar gcloud init

  4. Uma janela de terminal é aberta, e o comando gcloud init é executado.

  5. A instalação padrão não inclui as extensões do App Engine necessárias para implantar um aplicativo usando os comandos gcloud. Esses componentes podem ser instalados usando o gerenciador de componentes do Cloud SDK.

Observação: nas instâncias do Google Compute Engine em execução no 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".

Você também pode instalar a versão mais recente de um arquivo .zip do qual foi feito o 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 do qual foi feito o download e selecione Extrair tudo.

  2. Inicie o script google-cloud-sdk\install.bat e siga os prompts de instalação.

  3. Quando a instalação for concluída, reinicie o prompt de comando (cmd.exe).

  4. Execute gcloud init:

    C:\> gcloud init

Implantação não interativa (silenciosa)

É possível implantar o Cloud SDK sem prompts passando as sinalizações para o instalador. Isso permite automatizar a instalação do Cloud SDK.

Para Linux:

  • --disable-prompts desativa os prompts.

  • --install-dir=DIRECTORY define o diretório raiz de instalação como DIRECTORY. O Cloud SDK será instalado em DIRECTORY/google-cloud-sdk. O padrão é $HOME

Para Windows:

  • /S: faz uma instalação silenciosa. 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 aceitos, por exemplo /D=C:\CloudSDK
  • /allusers: instala para todos os usuários.
  • /singleuser: instala para o usuário atual (padrão).
  • /noreporting: desativa a geração de relatórios de uso (o padrão é enviar relatórios de uso).
  • /nostartmenu: não cria o atalho no menu Iniciar (o padrão é criar o atalho).
  • /nodesktop: não cria o atalho na área de trabalho (o padrão é criar o atalho).

Como gerenciar uma instalação

Depois de instalar o Cloud SDK usando um dos métodos acima, você pode usar comandos no grupo do gcloud components para gerenciar sua instalação. Isso inclui ver os componentes instalados, adicionar e remover componentes e fazer upgrade para uma nova versão do Cloud SDK.

A atualização e a remoção de componentes por meio do gcloud components será desativada se você instalar o Cloud SDK usando um dos métodos a seguir (apt-get ou yum).

apt-get (somente Debian e Ubuntu)

O Cloud SDK 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 Cloud SDK de 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 Cloud SDK é instalado por padrão. Ainda é possível instalar o Cloud SDK 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 Cloud SDK 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 o 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 tenha dificuldade em 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 Cloud SDK:
    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 principais de apt-get.
  5. Se preferir, 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-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

yum (Red Hat e 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 de yum, como a desativação de prompts ou simulações, consulte as páginas principais de yum.
  3. Se preferir, 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-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
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK