gRPC를 사용하여 Cloud Storage에 연결

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

C++

시작하기 전에

1. 다음 버전이 설치되었는지 확인합니다.

   • gRPC 버전 1.65.1 이상

   • C++ 클라이언트 라이브러리 버전 v2.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. gRPC를 사용하도록 C++ 클라이언트 라이브러리를 구성하려면 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
• 다른 Google Cloud 라이브러리가 포함된 Cloud Storage

독립형 Cloud Storage

다른Google Cloud 라이브러리 없이 Cloud Storage 클라이언트 라이브러리를 독립적으로 사용 중이면 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'

다른 Google Cloud 라이브러리가 포함된 Cloud Storage

다른 Google Cloud 라이브러리와 함께 Cloud Storage 클라이언트 라이브러리를 사용 중이면 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 클라이언트 만들기

클라이언트를 사용하려면 애플리케이션에서 NewClient 대신 NewGRPCClient 생성자를 호출해야 합니다.

// 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를 참조하세요.