Esta página mostra como começar a usar as bibliotecas de cliente do Cloud para a API Compute Engine. Bibliotecas cliente facilitam o acessoGoogle Cloud APIs de uma linguagem compatível. Embora você possa usarGoogle Cloud APIs diretamente, fazendo solicitações brutas ao servidor, as bibliotecas cliente fornecem simplificações que reduzem significativamente a quantidade de código que você precisa escrever.
Leia mais sobre as bibliotecas de cliente do Cloud e as antigas bibliotecas de cliente da API do Google em Bibliotecas de cliente explicadas .
Para seguir a orientação passo a passo para esta tarefa diretamente no console do Google Cloud, clique em Oriente-me :
Instale a biblioteca cliente
C++
Siga o Quickstart
.
C#
Instale o pacote Google.Cloud.Compute.V1
do NuGet.
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento C# .
Go
go get cloud.google.com/go/compute/apiv1
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento Go .
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
A versão mais antiga das bibliotecas de cliente do Cloud para Java para Compute Engine está disponível como versão 0.120.x ou anterior no artefato Maven . As versões 0.120.x e anteriores desta biblioteca são incompatíveis com versões posteriores.
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento Java .
Node.js
npm install @google-cloud/compute
A versão mais antiga das bibliotecas de cliente do Cloud para Node.js para Compute Engine está disponível como versão 2.5.x ou anterior no pacote npm . As versões 2.5.x e anteriores desta biblioteca são incompatíveis com versões posteriores.
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento Node.js.
PHP
composer require google/cloud-compute
Para obter mais informações, consulte Usando PHP no Google Cloud .
Python
pip install --upgrade google-cloud-compute
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento Python .
Ruby
gem install google-cloud-compute-v1
Para obter mais informações, consulte Configurando um ambiente de desenvolvimento Ruby .
Configurar autenticação
Para autenticar chamadas para Google Cloud APIs e bibliotecas de clientes suportam Application Default Credentials (ADC) ; as bibliotecas procuram credenciais em um conjunto de locais definidos e usam essas credenciais para autenticar solicitações à API. Com o ADC, você pode disponibilizar credenciais para seu aplicativo em diversos ambientes, como desenvolvimento local ou produção, sem precisar modificar o código do seu aplicativo.Para ambientes de produção, a forma como você configura o ADC depende do serviço e do contexto. Para obter mais informações, consulte Configurar credenciais padrão do aplicativo .
Para um ambiente de desenvolvimento local, você pode configurar o ADC com as credenciais associadas à sua Conta do Google:
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
Uma tela de login é exibida. Depois de entrar, suas credenciais serão armazenadas no arquivo de credenciais locais usado pelo ADC .
Use a biblioteca cliente
O exemplo a seguir mostra como usar a biblioteca cliente para listar instâncias em uma zona específica. Para obter mais exemplos, consulte Usando bibliotecas de cliente .
C#
Go
Java
Node.js
PHP
Python
Ruby
Recursos adicionais
C++
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para C++:
C#
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para C#:
Go
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente do Go:
Java
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para Java:
Node.js
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para Node.js:
PHP
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para PHP:
Python
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para Python:
Ruby
A lista a seguir contém links para mais recursos relacionados à biblioteca cliente para Ruby:
Bibliotecas clientes mais antigas
As bibliotecas de cliente do Cloud usam nosso modelo de biblioteca de cliente mais recente e são a opção recomendada para acessar APIs do Cloud de maneira programática.
Para os casos em que não é possível usar bibliotecas de cliente do Cloud, as seguintes bibliotecas de cliente da API do Google estão disponíveis:
Bibliotecas de cliente da API Compute Engine de terceiros
libcloud
libcloud é uma biblioteca Python usada para interagir com vários provedores de serviços em nuvem por meio de uma única API unificada.
O projeto da API Apache libcloud recebeu suporte e atualizações para o Compute Engine desde julho de 2013. Ele oferece suporte a um amplo conjunto de recursos do Compute Engine, incluindo instâncias, discos, redes e balanceadores de carga. A demonstração de primeiros passos fornece um exemplo de código de como usar libcloud e Compute Engine juntos.
jclouds
jclouds é uma biblioteca de código aberto que permite usar Java e Clojure em vários provedores de nuvem.
A API jclouds cloud oferece suporte ao Compute Engine e permite gerenciar recursos como máquinas virtuais, discos e redes. A partir da versão 1.9, o Compute Engine foi promovido para o núcleo jclouds.
nevoeiro.io
fog.io é uma biblioteca Ruby de código aberto que permite interagir com vários serviços em nuvem por meio de uma API.
A API de nuvem fog.io tem suporte para Compute Engine desde a versão 1.11.0 em maio de 2013. Ela oferece suporte a operações de instância, como criação e exclusão, juntamente com operações de gerenciamento para outros recursos, como discos, redes e balanceadores de carga.