התחברות ל-Cloud Storage באמצעות gRPC

C++‎

לפני שמתחילים

1. ודאו שהגרסאות הבאות מותקנות:

   • ‫gRPC בגרסה 1.65.1 ואילך

   • ספריית הלקוח C++‎ בגרסה v2.30.0 ואילך

   • ‫C++‎ מגרסה 14 ואילך

   הוראות להתקנה מופיעות במאמר הגדרת סביבת פיתוח בשפת C++‎.

2. מגדירים אימות.

3. חשוב לוודא שלכל מכונה ב-Compute Engine מצורף חשבון שירות, גם אם אין לחשבון השירות הרשאות. חשבון השירות הזה משמש לייצוג של מופע Compute Engine בתהליך לחיצת היד של אבטחת שכבת התעבורה של אפליקציה (ALTS), והוא נדרש לקישוריות ישירה.

הגדרת ספריית הלקוח C++‎

1. יצירת לקוח gRPC באמצעות gcs::MakeGrpcClient():

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

   ספריית הלקוח של C++‎ משתמשת אוטומטית בקישוריות ישירה כשהיא מזהה שהאפליקציה פועלת ב- Google Cloud.

2. כדי להגדיר את ספריית הלקוח ב-C++‎ לשימוש ב-gRPC, צריך להפעיל את לקוח gRPC של Cloud Storage כדי לעדכן את ההגדרה של מערכת build עבור CMake או Bazel.

   CMake

   1. מפעילים את הפלאגין של לקוח gRPC של Cloud Storage בזמן ההידור.

      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 מצורף חשבון שירות, גם אם אין לחשבון השירות הרשאות. חשבון השירות הזה משמש לייצוג של מופע Compute Engine בתהליך לחיצת היד של אבטחת שכבת התעבורה של אפליקציה (ALTS), והוא נדרש לקישוריות ישירה.

עדכון הפרויקט כדי להשתמש ב-BOM

כדי לוודא שבפרויקטים שלכם יש גרסאות תואמות של ספריות לקוח של Google Cloud , אתם יכולים להשתמש בגרסאות שמצוינות במפרט החומרים (BOM) של ספריותGoogle Cloud . כדי לעדכן את הפרויקט כך שישתמש ב-BOM, אפשר להשתמש באחת מהשיטות הבאות:

• Cloud Storage עצמאי
• Cloud Storage עם ספריות Google Cloud אחרות

אחסון בענן עצמאי

אם אתם משתמשים בספריית הלקוח של Cloud Storage באופן עצמאי (בלי ספריות אחרות שלGoogle Cloud ), אתם צריכים להשתמש ב-BOM שספציפי לספריית הלקוח של 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 עם ספריות Google Cloud אחרות

אם אתם משתמשים בספריית הלקוח של Cloud Storage יחד עם ספריות אחרות, אתם צריכים להשתמש ב-BOM של ספריות הלקוח. Google Cloud 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'

יצירת לקוח 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