Bibliotecas de cliente do Compute Engine

A API do Google Compute Engine é baseada em HTTP e JSON. Portanto, qualquer cliente HTTP padrão é pode de enviar solicitações a ela e analisar as respostas.

No entanto, em vez de criar solicitações HTTP e analisar respostas manualmente, convém usar as bibliotecas de cliente para isso. Nas bibliotecas de cliente há melhor integração de linguagens, mais segurança e compatibilidade na realização de chamadas que requerem autorização do usuário.

Use a API do Compute Engine em diversas bibliotecas fornecidas pelo Google ou em bibliotecas de código-fonte aberto de terceiros que funcionem no Compute Engine. Neste documento, descrevemos as bibliotecas fornecidas pelo Google, bem como algumas bibliotecas de código aberto de terceiros disponíveis.

Bibliotecas Disponíveis

Bibliotecas comunitárias

Biblioteca Linguagem(ns) Fornecedor Site Primeiros passos no Compute Engine
libcloud Python Comunidade Site Documentação
jclouds Java, Clojure Comunidade Site Documentação
fog.io Ruby Comunitária Site Documentação

Bibliotecas de cliente do Google Cloud

Biblioteca Linguagem(ns) Fornecedor Site Introdução ao Compute Engine
Biblioteca de cliente Node.js do Google Cloud Node.js Google Site Documentação

Bibliotecas de cliente da Google API

Biblioteca Linguagem(ns) Fornecedor Site Primeiros passos no Compute Engine
Biblioteca de cliente Java das APIs do Google Java Google Site Documentação
Biblioteca de cliente .NET das APIs do Google .NET Google Site Documentação
Biblioteca de cliente Go das APIs do Google Go Google Site Documentação
Biblioteca de cliente JavaScript das APIs do Google JavaScript Google Site Documentação
Biblioteca de cliente Ruby das APIs do Google Ruby Google Site Documentação
Biblioteca de cliente Node.js das APIs do Google Node.js Google Site Documentação
Biblioteca de cliente Objective C da Google API Objective C Google Site Documentação
Biblioteca de cliente PHP da Google API PHP Google Site Documentação
Biblioteca de cliente Python da API do Google Python Google Site Documentação

libcloud

libcloud é uma biblioteca Python que proporciona interação com muitos provedores de serviços famosos do Cloud por meio de uma API unificada.

Notas do Compute Engine

O projeto Apache libcloud API tem grande compatibilidade com o Compute Engine e recebe atualizações para ele desde julho de 2013. Ele é compatível com um conjunto amplo de recursos do Compute Engine, inclusive instâncias, discos, redes/firewalls e balanceador de carga. A demonstração de primeiros passos é muito útil e oferece um bom exemplo em código de como usar a libcloud e o Compute Engine.

jclouds

jclouds é uma biblioteca de código aberto que permite o uso de Java e Clojure em vários provedores do Cloud.

Notas do Compute Engine

A Cloud API da jclouds é compatível com o Compute Engine e permite que os usuários gerenciem diversos recursos, como máquinas virtuais, discos e redes. A partir da versão 1.9, o Compute Engine foi promovido ao núcleo da jclouds.

fog.io

fog.io é uma biblioteca Ruby de código aberto que permite interagir com vários serviços do Cloud por meio de uma API.

Notas do Compute Engine

A Cloud API da fog.io é compatível com o Compute Engine desde a versão 1.11.0, de maio de 2013. Confira a documentação da fog.io para começar a usar o Compute Engine e a fog. Ela é compatível com operações de instância, como criar, destruir e executar bootstrap, além de permitir o gerenciamento de outros recursos, como discos, redes e balanceadores de carga.

Biblioteca de cliente Node.js do Google Cloud

Leia o guia de primeiros passos do Node.js do Compute Engine.

Biblioteca de cliente Java das APIs do Google

Nesta página, descrevemos como começar a usar a API do Compute Engine usando a Biblioteca de cliente da API do Google para Java. Além disso, talvez você se interesse pela seguinte documentação:

Amostra

A compute-engine-cmdline-sample o ajudará nos primeiros passos com o uso da biblioteca de cliente.

Adicionar biblioteca ao seu projeto

Selecione o ambiente de criação Maven ou Gradle nas guias abaixo ou faça o download de um arquivo zip com todos os jars necessários:

Biblioteca de cliente .NET das APIs do Google

Esta página contém informações sobre como começar a usar a Compute Engine API usando a biblioteca de cliente da Google API para .NET. Além disso, a documentação a seguir pode ser do seu interesse:

Fazer o download da biblioteca

Instale um pacote NuGet disponível em Google.Apis.compute.

Biblioteca de cliente Go das APIs do Google

Esta seção contém informações sobre como começar a usar a Compute Engine API usando a biblioteca de cliente Go das Google APIs. Além disso, talvez você se interesse pela seguinte documentação:

Como fazer o download e a instalação da biblioteca

Para instalar a biblioteca, execute o comando a seguir:

go get google.golang.org/api/compute/v1

Como usar a biblioteca

Importe a biblioteca no seu código:

package main

  import (
      "google.golang.org/api/compute/v1"
  )

Biblioteca de cliente JavaScript das APIs do Google

Nesta seção, você encontra informações sobre os primeiros passos no uso da API do Compute Engine usando a biblioteca cliente JavaScript das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:

Como usar a API

Para usar a API, primeiro carregue a biblioteca. No seu código, adicione:

<script src="https://apis.google.com/js/client.js?onload=handleClientLoad"></script>

Biblioteca de cliente Ruby das APIs do Google

Nesta página, você encontra informações sobre como começar a usar a API do Compute Engine usando a Biblioteca de cliente da API do Google para Ruby. Além disso, talvez você se interesse pela seguinte documentação:

Como instalar a gem google-api-client

Caso a biblioteca de cliente da API do Google para Ruby ainda não esteja instalada, abra um terminal e instale-a usando o RubyGems: 

$ gem install google-api-client

Caso você já tenha a gem instalada e simplesmente queira atualizar para a versão mais recente: 

$ gem update -y google-api-client

Dependendo do sistema, talvez seja necessário prefixar esses comandos com o sudo.

Primeiros passos com a biblioteca de cliente da API do Google para Ruby

Consulte o nosso Guia de primeiros passos completo para uma visão geral de como fazer sua primeira solicitação.

Biblioteca de cliente Node.js das APIs do Google

Leia o guia de primeiros passos do Node.js do Compute Engine.

Biblioteca de cliente Objective C das APIs do Google

Nesta seção, você encontra informações sobre os primeiros passos no uso da API do Compute Engine com a biblioteca de cliente Objective C das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:

Como fazer a vinculação com a biblioteca

Siga as instruções para adicionar a biblioteca de cliente Objective-C das APIs do Google a um projeto.

Biblioteca de cliente PHP das APIs do Google

Nesta seção, você encontra informações sobre os primeiros passos com a API do Compute Engine usando a biblioteca de cliente PHP das APIs do Google. Além disso, talvez você se interesse pela seguinte documentação:

Como fazer o download da biblioteca

Instale a biblioteca adicionando-a como dependência ao composer.json.

"require": {
  "google/apiclient": "1.0.*"
}

Caso prefira, faça a clonagem da biblioteca disponível no GitHub em um repositório local com o método git clone.

git clone https://github.com/google/google-api-php-client.git .

Como usar a biblioteca

A melhor maneira de definir a localização dos arquivos das bibliotecas é adicioná-la ao caminho no arquivo de configuração PHP.ini.

include_path = ".:/usr/local/lib/php:/path/to/google-api-php-client/src"

Como alternativa, é possível definir a mesma diretiva ini dinamicamente no código.

set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/google-api-php-client/src');

Biblioteca de cliente Python das APIs do Google

Esta página contém informações sobre como começar com a Compute Engine API usando a biblioteca de cliente da Google API para Python. Além disso, a documentação a seguir pode ser do seu interesse:

Requisitos do sistema

Como instalar a biblioteca de cliente

Use um gerenciador de pacotes ou faça o download e instale manualmente a biblioteca de cliente em Python:

Instalação gerenciada

Use o pip ou setuptools para gerenciar sua instalação. Talvez seja necessário executar primeiro o sudo:

  • pip (preferencial): 
    $ pip install --upgrade google-api-python-client
  • Setuptools: use a ferramenta easy_install incluída no pacote setuptools: 
    $ easy_install --upgrade google-api-python-client

Instalação manual

Faça o download da biblioteca de cliente mais recente do Python, descompacte o código e execute python setup.py install.

App Engine

Como as bibliotecas de cliente do Python não estão instaladas no ambiente de execução do App Engine para Python, é preciso disponibilizá-las no aplicativo, assim como as bibliotecas de terceiros.