Bibliotecas cliente de Cloud Deploy

En esta página, se muestra cómo comenzar a usar las bibliotecas cliente de Cloud para la API de Cloud Deploy. Las bibliotecas cliente facilitan el acceso a las APIs de Google Cloud mediante un lenguaje admitido. Puedes usar las APIs de Google Cloud directamente mediante solicitudes sin procesar al servidor, pero las bibliotecas cliente proporcionan simplificaciones que reducen de manera significativa la cantidad de código que debes escribir.

Sin embargo, te recomendamos usar las bibliotecas cliente de las APIs de Google más antiguas si se ejecutan en el entorno estándar de App Engine. Obtén más información sobre las bibliotecas cliente de Cloud y las bibliotecas cliente de la API de Google anteriores en Explicación de las bibliotecas cliente.

Instala la biblioteca cliente

C++

Consulta Configura un entorno de desarrollo de C++ para obtener detalles sobre los requisitos de esta biblioteca cliente y, luego, instala las dependencias.

C#

Install-Package Google.Cloud.Deploy.V1 -Pre

    
For more information, see Setting Up a C# Development Environment.

Go

go get cloud.google.com/go/storage

Para obtener más información, consulta Configura un entorno de desarrollo de Go.

Java

Si usas Maven, agrega esto a tu archivo pom.xml:

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-deploy</artifactId>
    <version></version>
</dependency>

Si usas Gradle, agrega lo siguiente a tus dependencias:

compile group: 'com.google.cloud', name: 'google-cloud-deploy', version: ''

Para obtener más información, consulta Configura un entorno de desarrollo de Java.

Node.js

npm install --save @google-cloud/deploy

Para obtener más información, consulta Configura un entorno de desarrollo de Node.js.

PHP

composer require google/cloud-deploy

Para obtener más información, consulta PHP en Google Cloud.

Python

pip install --upgrade google-cloud-deploy

Para obtener más información, consulta Configura un entorno de desarrollo de Python.

Ruby

gem install google-cloud-deploy

Para obtener más información, consulta Cómo configurar un entorno de desarrollo en Ruby.

Configura la autenticación

Para autenticar llamadas a las API de Google Cloud, las bibliotecas cliente son compatibles con las credenciales predeterminadas de la aplicación (ADC). Las bibliotecas buscan credenciales en un conjunto de ubicaciones definidas y las usan para lo siguiente: autenticar solicitudes en la API. Con ADC, puedes hacer que las credenciales estén disponibles para tu aplicación en una variedad de entornos, como el desarrollo o producción local, sin necesidad de modificar el código de la aplicación.

Para los entornos de producción, la forma en que configuras ADC depende del servicio y el contexto. Para obtener más información, consulta Configura credenciales predeterminadas de la aplicación.

Para un entorno de desarrollo local, puedes configurar ADC con las credenciales asociadas con tu cuenta de Google:

1. Instala e inicializa gcloud CLI

   Cuando inicialices gcloud CLI, asegúrate de especificar un proyecto de Google Cloud en el que tengas permiso para acceder a los recursos que necesita tu aplicación.

2. Crea tu archivo de credenciales:

   gcloud auth application-default login

   Aparecerá una pantalla de acceso. Después de acceder, tus credenciales se almacenan en el archivo de credenciales local que usa ADC.

Usa la biblioteca cliente

En el siguiente ejemplo, se muestra cómo usar la biblioteca cliente.

C++

#include "google/cloud/deploy/v1/cloud_deploy_client.h"
#include "google/cloud/location.h"
#include <iostream>

int main(int argc, char* argv[]) try {
  if (argc != 3) {
    std::cerr << "Usage: " << argv[0] << " project-id location-id\n";
    return 1;
  }

  auto const location = google::cloud::Location(argv[1], argv[2]);

  namespace deploy = ::google::cloud::deploy_v1;
  auto client = deploy::CloudDeployClient(deploy::MakeCloudDeployConnection());

  for (auto dp : client.ListDeliveryPipelines(location.FullName())) {
    if (!dp) throw std::move(dp).status();
    std::cout << dp->DebugString() << "\n";
  }

  return 0;
} catch (google::cloud::Status const& status) {
  std::cerr << "google::cloud::Status thrown: " << status << "\n";
  return 1;
}

Node.js

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent, which owns this collection of pipelines. Format must be
 *  projects/{project_id}/locations/{location_name}.
 */
// const parent = 'abc123'
/**
 *  The maximum number of pipelines to return. The service may return
 *  fewer than this value. If unspecified, at most 50 pipelines will
 *  be returned. The maximum value is 1000; values above 1000 will be set
 *  to 1000.
 */
// const pageSize = 1234
/**
 *  A page token, received from a previous `ListDeliveryPipelines` call.
 *  Provide this to retrieve the subsequent page.
 *  When paginating, all other provided parameters match
 *  the call that provided the page token.
 */
// const pageToken = 'abc123'
/**
 *  Filter builds to be returned. See https://google.aip.dev/160 for more
 *  details.
 */
// const filter = 'abc123'
/**
 *  Field to sort by. See https://google.aip.dev/132#ordering for more details.
 */
// const orderBy = 'abc123'

// Imports the Deploy library
const {CloudDeployClient} = require('@google-cloud/deploy').v1;

// Instantiates a client
const deployClient = new CloudDeployClient();

async function listDeliveryPipelines() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = await deployClient.listDeliveryPipelinesAsync(request);
  for await (const response of iterable) {
    console.log(response);
  }
}

listDeliveryPipelines();

Recursos adicionales

C++

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente de C++:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

C#

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente para C#:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

Go

En la siguiente lista, se incluyen vínculos a más recursos relacionados con la biblioteca cliente para Go:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

Java

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente para Java:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

Node.js

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente de Node.js:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

PHP

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente para PHP:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

Python

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente para Python:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente

Ruby

La siguiente lista contiene vínculos a más recursos relacionados con la biblioteca cliente para Ruby:

• Referencia de la API
• Prácticas recomendadas sobre las bibliotecas cliente
• Seguimiento de problemas
• google-cloud-deploy en Stack Overflow
• Código fuente