Conéctate a Cloud Storage con gRPC

C++

Antes de comenzar

1. Asegúrate de tener instaladas las siguientes versiones:

   • gRPC versión 1.65.1 o posterior

   • Versión 2.30.0 o posterior de la biblioteca cliente de C++

   • C++ versión 14 o posterior

   Para obtener instrucciones de instalación, consulta Configura un entorno de desarrollo de C++.

2. Configura la autenticación.

3. Asegúrate de que cada instancia de Compute Engine tenga una cuenta de servicio adjunta, incluso si la cuenta de servicio no tiene permisos. Esta cuenta de servicio se usa para representar la instancia de Compute Engine en el proceso de protocolo de enlace de la Seguridad de transporte de la capa de la aplicación (ALTS) y es necesaria para la conectividad directa.

Configura la biblioteca cliente de C++

1. Crea un cliente de gRPC con gcs::MakeGrpcClient():

     namespace gcs = google::cloud::storage;
     void App() {
      auto client = gcs::MakeGrpcClient();
   
     // application code
   
     }
   

   La biblioteca cliente de C++ usa automáticamente la conectividad directa cuando detecta que la aplicación se ejecuta en Google Cloud.

2. Para configurar la biblioteca cliente de C++ para que use gRPC, habilita el cliente de gRPC de Cloud Storage para actualizar la configuración del sistema de compilación para CMake o Bazel.

   CMake

   1. Habilita el complemento del cliente de gRPC de Cloud Storage en el momento de la compilación.

      cmake -DGOOGLE_CLOUD_CPP_ENABLE=storage_grpc [other options here]
      

   2. En tu base de código, para el comando target_link_libraries(), reemplaza google-cloud-cpp::storage por google-cloud-cpp::storage_grpc.

      Por ejemplo, el programa de inicio rápido para gRPC usa el siguiente código:

      add_executable(quickstart_grpc quickstart_grpc.cc)
      target_link_libraries(quickstart_grpc google-cloud-cpp::storage_grpc)
      

   Bazel

   Reemplaza las dependencias de @google_cloud_cpp//:storage a @google_cloud_cpp//:storage_grpc.

   Por ejemplo, el programa de inicio rápido para gRPC usa el siguiente código:

     cc_binary(
         name = "quickstart",
         srcs = [
             "quickstart.cc",
         ],
         deps = [
             "@com_github_googleapis_google_cloud_cpp//:storage_grpc",
         ],
     )
   

Java

Antes de comenzar

1. Asegúrate de tener instaladas las siguientes versiones:

   • Bibliotecas cliente de Java:

     • com.google.cloud:google-cloud-storage:2.43.1 o una versión posterior
     • com.google.cloud:libraries-bom:26.48 o una versión posterior

   • Java 8 o versiones posteriores

   Si deseas obtener instrucciones para la instalación, consulta Configura un entorno de desarrollo de Java.

2. Configura la autenticación.

3. Asegúrate de que cada instancia de Compute Engine tenga una cuenta de servicio adjunta, incluso si la cuenta de servicio no tiene permisos. Esta cuenta de servicio se usa para representar la instancia de Compute Engine en el proceso de protocolo de enlace de la Seguridad de transporte de la capa de la aplicación (ALTS) y es necesaria para la conectividad directa.

Actualiza tu proyecto para usar la BOM

Para asegurarte de que tus proyectos tengan versiones compatibles de las bibliotecas cliente de Google Cloud , usa las versiones especificadas en la lista de materiales (BOM) de las bibliotecas deGoogle Cloud . Para actualizar tu proyecto y usar la BOM, usa cualquiera de los siguientes métodos:

• Cloud Storage independiente
• Cloud Storage con otras bibliotecas Google Cloud

Cloud Storage independiente

Si usas la biblioteca cliente de Cloud Storage de forma independiente (sin otras bibliotecas deGoogle Cloud ), usa la BOM específica de la biblioteca cliente de Cloud Storage.

<dependencyManagement>
  <dependencies>
  <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-storage-bom</artifactId>
   <version>2.43.1</version>
   <type>pom</type>
   <scope>import</scope>
  </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-storage</artifactId>
  </dependency>
</dependencies>

implementation platform('com.google.cloud:google-cloud-storage-bom:2.43.1')
implementation 'com.google.cloud:google-cloud-storage'

Cloud Storage con otras bibliotecas Google Cloud

Si usas la biblioteca cliente de Cloud Storage junto con otras bibliotecas de Google Cloud , usa la BOM de las bibliotecas cliente de Google Cloud .

<dependencyManagement>
  <dependencies>
  <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>libraries-bom</artifactId>
   <version>26.48.0</version>
   <type>pom</type>
   <scope>import</scope>
  </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-storage</artifactId>
  </dependency>
</dependencies>

implementation platform('com.google.cloud:libraries-bom:26.48.0')
implementation 'com.google.cloud:google-cloud-storage'

Crea un cliente de gRPC

En el siguiente ejemplo, se usa un compilador centrado en gRPC. El cliente de gRPC Java usa automáticamente la conectividad directa cuando detecta que la aplicación se ejecuta en Google Cloud.

// Imports the Google Cloud client library
import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.BucketInfo;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class QuickstartGrpcSample {
  public static void main(String... args) throws Exception {

    // Create an instance of options which will use the Google Cloud Storage gRPC API for all
    // operations
    StorageOptions options = StorageOptions.grpc().build();

    // Instantiates a client in a try-with-resource to automatically cleanup underlying resources
    try (Storage storage = options.getService()) {
      // The name for the new bucket
      String bucketName = args[0]; // "my-new-bucket";

      // Creates the new bucket using a request to the gRPC API
      Bucket bucket = storage.create(BucketInfo.of(bucketName));

      System.out.printf("Bucket %s created.%n", bucket.getName());
    }
  }
}

Go

Antes de comenzar

1. Configura tu entorno de desarrollo.

2. Asegúrate de usar la versión 1.46.0 o posterior de la biblioteca cliente de Go para Cloud Storage.

3. Configura la autenticación.

4. Asegúrate de que cada instancia de Compute Engine tenga una cuenta de servicio adjunta, incluso si la cuenta de servicio no tiene permisos. Esta cuenta de servicio se usa para representar la instancia de Compute Engine en el proceso de protocolo de enlace de la Seguridad de transporte de la capa de la aplicación (ALTS) y es necesaria para la conectividad directa.

Crea un cliente de gRPC

Para usar el cliente, debes llamar al constructor NewGRPCClient en tu aplicación en lugar de NewClient.

// Sample storage-quickstart creates a Google Cloud Storage bucket using
// gRPC API.
package main

import (
	"context"
	"fmt"
	"log"
	"time"

	"cloud.google.com/go/storage"
)

func main() {
	ctx := context.Background()

	// Use your Google Cloud Platform project ID and Cloud Storage bucket
	projectID := "project-id"
	bucketName := "bucket-name"

	// Creates a gRPC enabled client.
	client, err := storage.NewGRPCClient(ctx)
	if err != nil {
		log.Fatalf("Failed to create client: %v", err)
	}
	defer client.Close()

	// Creates the new bucket.
	ctx, cancel := context.WithTimeout(ctx, time.Second*10)
	defer cancel()
	if err := client.Bucket(bucketName).Create(ctx, projectID, nil); err != nil {
		log.Fatalf("Failed to create bucket: %v", err)
	}

	fmt.Printf("Bucket %v created.\n", bucketName)
}

La biblioteca cliente de Go usa automáticamente la conectividad directa cuando detecta que la aplicación se ejecuta en Google Cloud.

Para obtener información sobre cómo usar un cliente de gRPC, consulta la API de gRPC.