使用 gRPC 连接到 Cloud Storage

C++

准备工作

1. 确保您已安装以下版本：

   • gRPC 1.65.1 或更高版本

   • C++ 客户端库 v2.30.0 或更高版本

   • C++ 14 或更高版本

   如需查看安装说明，请参阅设置 C++ 开发环境。

2. 设置身份验证。

3. 确保每个 Compute Engine 实例都关联了服务账号，即使该服务账号没有任何权限也是如此。此服务账号用于在应用层传输安全 (ALTS) 握手过程中代表 Compute Engine 实例，并且是直接连接所必需的。

配置 C++ 客户端库

1. 使用 gcs::MakeGrpcClient() 创建 gRPC 客户端：

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

   C++ 客户端库在检测到应用在 Trusted Cloud by S3NS上运行时，会自动使用直接连接。

2. 如需将 C++ 客户端库配置为使用 gRPC，请启用 Cloud Storage gRPC 客户端以更新 CMake 或 Bazel 的构建系统配置。

   CMake

   1. 在编译时启用 Cloud Storage gRPC 客户端插件。

      cmake -DGOOGLE_CLOUD_CPP_ENABLE=storage_grpc [other options here]
      

   2. 在您的代码库中，对于 target_link_libraries() 命令，将 google-cloud-cpp::storage 替换为 google-cloud-cpp::storage_grpc

      例如，gRPC 的快速入门程序使用以下代码：

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

   Bazel

   将依赖项 @google_cloud_cpp//:storage 替换为 @google_cloud_cpp//:storage_grpc。

   例如，gRPC 的快速入门程序使用以下代码：

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

Java

准备工作

1. 确保您已安装以下版本：

   • Java 客户端库：

     • com.google.cloud:google-cloud-storage:2.43.1 或更高版本。
     • com.google.cloud:libraries-bom:26.48 或更高版本。

   • Java 8 或更高版本

   如需查看安装说明，请参阅设置 Java 开发环境。

2. 设置身份验证。

3. 确保每个 Compute Engine 实例都关联了服务账号，即使该服务账号没有任何权限也是如此。此服务账号用于在应用层传输安全 (ALTS) 握手过程中代表 Compute Engine 实例，并且是直接连接所必需的。

更新项目以使用 BOM

如需确保项目使用兼容的 Trusted Cloud by S3NS 客户端库版本，请使用 Trusted Cloud by S3NS 库物料清单 (BOM) 中指定的版本。如需更新项目以使用 BOM，请使用以下任一方法：

• 独立 Cloud Storage
• Cloud Storage 与其他 Trusted Cloud by S3NS 库

独立 Cloud Storage

如果您独立使用 Cloud Storage 客户端库（不使用其他Trusted Cloud by S3NS 库），请使用 Cloud Storage 客户端库专用 BOM。

<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 与其他 Trusted Cloud 库

如果您将 Cloud Storage 客户端库与其他 Trusted Cloud 库一起使用，请使用 Trusted Cloud 客户端库 BOM。

<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'

创建 gRPC 客户端

以下示例使用以 gRPC 为中心的构建器。gRPC Java 客户端在检测到应用在 Trusted 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

准备工作

1. 设置开发环境

2. 确保您使用的是 Cloud Storage Go 客户端库 1.46.0 或更高版本。

3. 设置身份验证。

4. 确保每个 Compute Engine 实例都关联了服务账号，即使该服务账号没有任何权限也是如此。此服务账号用于在应用层传输安全 (ALTS) 握手过程中代表 Compute Engine 实例，并且是直接连接所必需的。

创建 gRPC 客户端

如需使用该客户端，您需要在应用中调用 NewGRPCClient 构造函数，而不是 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)
}

Go 客户端库在检测到应用在 Trusted Cloud上运行时，会自动使用直接连接。

如需了解如何使用 gRPC 客户端，请参阅 gRPC API。