gRPC è un framework RPC universale open source ad alte prestazioni sviluppato da Google che puoi utilizzare per definire i tuoi servizi utilizzando i buffer di protocollo. Puoi utilizzare gRPC per interagire con Cloud Storage. gRPC utilizza la connettività diretta tra l'istanza Compute Engine e i bucket Cloud Storage, bypassando i front-end di Google (GFEs).
Puoi connetterti a Cloud Storage utilizzando gRPC tramite i seguenti client supportati:
Connettore I/O Apache Beam su Dataflow per richieste di lettura e scrittura.
Librerie client di Cloud Storage per C++, Go e Java. Per istruzioni su come attivare gRPC per queste librerie client, consulta Attivare gRPC nella libreria client.
Cloud Storage FUSE. Per utilizzare Cloud Storage FUSE come client, specifica
grpc
nelclient-protocol
campo utilizzando un file di configurazione Cloud Storage FUSE o il--client-protocol
flag utilizzando l'interfaccia a riga di comando gcsfuse.
L'utilizzo di gRPC per connettersi a Cloud Storage dovrebbe migliorare le prestazioni di lettura per i carichi di lavoro di analisi in esecuzione su Google Cloud solo se l'istanza Compute Engine e i bucket Cloud Storage si trovano nella stessa regione. Sconsigliamo di utilizzare gRPC per i bucket in regioni multiregionali e con due regioni.
Attivare gRPC in una libreria client
C++
Prima di iniziare
Assicurati di aver installato le seguenti versioni:
gRPC versione 1.65.1 o successive
Libreria client C++ versione 2.30.0 o successive
C++ versione 14 o successive
Per le istruzioni di installazione, consulta Configurare un ambiente di sviluppo C++.
Configura la libreria client C++
Crea un client gRPC utilizzando
gcs::MakeGrpcClient()
:namespace gcs = google::cloud::storage; void App() { auto client = gcs::MakeGrpcClient(); // application code }
La libreria client C++ utilizza automaticamente la connettività diretta quando rileva che l'applicazione è in esecuzione su Google Cloud.
Per configurare la libreria client C++ in modo che utilizzi gRPC, abilita il client gRPC di Cloud Storage per aggiornare la configurazione del sistema di compilazione per CMake o Bazel.
CMake
Attiva il plug-in client gRPC di Cloud Storage al compilatore.
cmake -DGOOGLE_CLOUD_CPP_ENABLE=storage_grpc [other options here]
Nel codice di base, per il comando
target_link_libraries()
sostituiscigoogle-cloud-cpp::storage
congoogle-cloud-cpp::storage_grpc
Ad esempio, il programma di avvio rapido per gRPC utilizza il seguente codice:
add_executable(quickstart_grpc quickstart_grpc.cc) target_link_libraries(quickstart_grpc google-cloud-cpp::storage_grpc)
Bazel
Sostituisci le dipendenze da
@google_cloud_cpp//:storage
a@google_cloud_cpp//:storage_grpc
.Ad esempio, il programma di avvio rapido per gRPC utilizza il seguente codice:
cc_binary( name = "quickstart", srcs = [ "quickstart.cc", ], deps = [ "@com_github_googleapis_google_cloud_cpp//:storage_grpc", ], )
Java
Prima di iniziare
Assicurati di aver installato le seguenti versioni:
Librerie client Java:
com.google.cloud:google-cloud-storage:2.43.1
o versioni successive.com.google.cloud:libraries-bom:26.48
o versioni successive.
Java 8 o versioni successive
Per le istruzioni di installazione, consulta Configurazione di un ambiente di sviluppo Java.
Aggiorna il progetto per utilizzare la distinta componenti
Per assicurarti che i tuoi progetti dispongano di versioni compatibili delle Google Cloud librerie client, utilizza le versioni specificate nel Google Cloud Bill of Materials (BOM) delle librerie. Per aggiornare il progetto in modo che utilizzi il BOM, utilizza uno dei seguenti metodi:
Cloud Storage autonomo
Se utilizzi la libreria client di Cloud Storage in modo indipendente (senza altre Google Cloud librerie), utilizza il BOM specifico della libreria client di Cloud Storage.
Maven
Importa la BOM nella sezione dependencyManagement
del file pom.xml
.
L'esempio seguente mostra come importare la BOM e includere l'elemento google-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>
Gradle
Aggiungi una dipendenza dalla piattaforma su com.google.cloud:google-cloud-storage-bom
:
implementation platform('com.google.cloud:google-cloud-storage-bom:2.43.1')
implementation 'com.google.cloud:google-cloud-storage'
Cloud Storage con altre Google Cloud librerie
Se utilizzi la libreria client di Cloud Storage insieme ad altre Google Cloud librerie, utilizza il BOM delle librerie client Google Cloud .
Maven
Importa la BOM nella sezione dependencyManagement
del file pom.xml
.
L'esempio seguente mostra come importare la BOM e includere l'elemento libraries-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>
Gradle
Aggiungi una dipendenza dalla piattaforma su com.google.cloud:libraries-bom
:
implementation platform('com.google.cloud:libraries-bom:26.48.0')
implementation 'com.google.cloud:google-cloud-storage'
Crea un client gRPC
L'esempio seguente utilizza un generatore incentrato su gRPC. Il client Java gRPC utilizza automaticamente la connettività diretta quando rileva che l'applicazione è in esecuzione su Google Cloud.
Vai
Prima di iniziare
Assicurati di utilizzare la libreria client Go di Cloud Storage versione 1.46.0 o successive.
Crea un client gRPC
Per utilizzare il client, devi chiamare il costruttore NewGRPCClient
nella tua applicazione anziché NewClient
.
La libreria client Go utilizza automaticamente la connettività diretta quando rileva che l'applicazione è in esecuzione su Google Cloud.
Per informazioni su come utilizzare un client gRPC, consulta l'API gRPC.
Configurazione dei Controlli di servizio VPC
Se utilizzi Virtual Private Cloud con indirizzi IP virtuali limitati (VPC Service Controls) per migliorare la sicurezza della tua rete, devi aggiornare le regole del firewall per attivare la connettività diretta per un funzionamento ottimale tra l'istanza Compute Engine e Cloud Storage.
A tale scopo, aggiungi regole firewall della lista consentita per consentire il traffico su tutte le porte per i seguenti blocchi CIDR:
- Per il traffico IPv4:
34.126.0.0/18
- Per il traffico IPv6:
2001:4860:8040::/42
Oltre alle regole precedenti, mantieni la regola della lista consentita esistente per
199.36.153.4/30
.
Se hai limitazioni per le modifiche delle regole del firewall e non puoi aggiornarle, puoi forzare il traffico a evitare la connettività diretta utilizzando storage.googleapis.com
come endpoint Cloud Storage anziché google-c2p://storage.googleapis.com
.
Ad esempio, per C++ utilizza .set<google::cloud::EndpointOption>(storage.googleapis.com)
instead of google-c2p:///storage.googleapis.com
.
Attivare l'osservabilità per le richieste correlate a gRPC
Puoi configurare le librerie client di Cloud Storage per generare metriche relative a gRPC in Cloud Monitoring. Le metriche relative a gRPC possono aiutarti a:
Monitora e ottimizza le prestazioni delle richieste gRPC a Cloud Storage.
Risolvi i problemi ed esegui il debug.
Ottieni informazioni sull'utilizzo e sul comportamento della tua applicazione.
Per informazioni su come generare metriche relative a gRPC, consulta Utilizzare le metriche lato client.
Se la raccolta delle metriche non è necessaria per il tuo caso d'uso, puoi scegliere di disattivarla. Per istruzioni, vedi Disattivare le metriche lato client.
Limitazioni
Le richieste IPv6 non possono essere inviate tramite reti legacy.
La connettività diretta non è supportata quando si utilizzano le seguenti versioni di GKE su cluster solo IPv4:
- 1.28, 1.28.0-gke.100 o successive fino a 1.28.5-gke.1199000
- 1.27, 1.27.4-gke.1900 o versioni successive
- 1.26, 1.26.10-gke.1238000 o versioni successive
- 1.25, 1.25.15-gke.1045000 o versioni successive
gRPC non supporta i metodi notifications, hmacKeys e serviceAccount.
Le opzioni del costruttore del client specifiche per HTTP, come WithHTTPClient, non sono supportate per la libreria client Go.
Passaggi successivi
- Connettiti al connettore Cloud Storage su Dataproc utilizzando gRPC.
- Abilita gRPC sul connettore I/O Apache Beam su Dataflow.