使用 gRPC 連線至 Cloud Storage

C++

事前準備

1. 請確認已安裝下列版本：

   • gRPC 1.65.1 以上版本

   • C++ 用戶端程式庫第 2.30.0 版以上

   • C++ 14 以上版本

   如需安裝操作說明，請參閱「設定 C++ 開發環境」。

2. 設定驗證方法。

設定 C++ 用戶端程式庫

1. 使用 gcs::MakeGrpcClient() 建立 gRPC 用戶端：

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

   當 C++ 用戶端程式庫偵測到應用程式在 Google Cloud上執行時，會自動使用直接連線。

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. 設定驗證方法。

更新專案以使用 BOM

為確保專案具有相容的 Google Cloud 用戶端程式庫版本，請使用 Google Cloud 程式庫物料清單 (BOM) 中指定的版本。如要更新專案以使用 BOM，請使用下列任一方法：

• 獨立 Cloud Storage
• Cloud Storage 與其他 Google Cloud 程式庫

獨立 Cloud Storage

如果您獨立使用 Cloud Storage 用戶端程式庫 (不使用其他Google Cloud 程式庫)，請使用 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 與其他 Google Cloud 程式庫搭配使用

如果您同時使用 Cloud Storage 用戶端程式庫和其他 Google Cloud 程式庫，請使用 Google 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 用戶端偵測到應用程式在 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

事前準備

1. 設定開發環境。

2. 請務必使用 Cloud Storage Go 用戶端程式庫 1.46.0 以上版本。

3. 設定驗證方法。

建立 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 用戶端程式庫偵測到應用程式在 Google Cloud上執行時，就會自動使用直接連線。

如要瞭解如何使用 gRPC 用戶端，請參閱 gRPC API。