Panoramica di gRPC

gRPC è un framework RPC universale open source ad alte prestazioni sviluppato da Google. In gRPC, un'applicazione client può chiamare direttamente metodi su un'applicazione server su un altro computer come se fosse un oggetto locale, semplificando la creazione di servizi e applicazioni distribuite.

Uno dei principali vantaggi dell'utilizzo di gRPC è la documentazione. Puoi utilizzare i file di configurazione del servizio e di definizione dell'interfaccia API per generare la documentazione di riferimento per la tua API.

Gestione delle API

Con API Gateway per gRPC, puoi utilizzare le funzionalità di gestione delle API di API Gateway per aggiungere monitoraggio, hosting, monitoraggio, autenticazione e altro ancora ai tuoi servizi gRPC su Cloud Run. Inoltre, dopo aver specificato regole di mappatura speciali, API Gateway traduce JSON RESTful su HTTP in richieste gRPC. Ciò significa che puoi eseguire il deployment di un server gRPC gestito da API Gateway e chiamarne l'API utilizzando un client gRPC o JSON/HTTP, il che ti offre molta più flessibilità e facilità di integrazione con altri sistemi.

Puoi creare servizi gRPC per API Gateway in qualsiasi lingua supportata da gRPC. Puoi scoprire molto di più su gRPC, incluse guide rapide e tutorial per la creazione di server e client, sul sito gRPC.

Definizione e configurazione del servizio

gRPC si basa sull'idea di definire un servizio, specificando i metodi che possono essere chiamati da remoto con i relativi parametri e tipi di ritorno. Per impostazione predefinita, gRPC utilizza protocol buffers come linguaggio di definizione dell'interfaccia (IDL) per descrivere sia l'interfaccia del servizio sia la struttura dei messaggi del payload.

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

Per utilizzare gRPC con API Gateway, devi fornire una configurazione del servizio insieme alla definizione del servizio. In questo modo viene configurato il comportamento di runtime del servizio, inclusa l'autenticazione, le API incluse nel servizio, le mappature dalle richieste HTTP ai metodi gRPC e le impostazioni speciali di API Gateway.

Transcodifica

API Gateway fornisce la traduzione del protocollo per i tuoi servizi gRPC su Cloud Run, consentendo ai client di utilizzare HTTP/JSON per comunicare con un servizio gRPC tramite API Gateway.

Il caso d'uso più comune è consentire ai client del browser di comunicare con i server gRPC senza il supporto speciale delle librerie client gRPC. API Gateway fornisce un meccanismo per mappare le richieste HTTP ai metodi gRPC nell'ambito della configurazione del servizio.

Scopri di più in Transcodifica di HTTP/JSON in gRPC.

Nota: quando utilizzi la transcodifica gRPC, le dimensioni del corpo della richiesta e della risposta che superano un megabyte potrebbero comportare risposte 500 Internal Server Error.

Se questa dimensione viene superata, i log delle richieste per API Gateway mostreranno grpc_json_transcode_failure{request_buffer_size_limit_reached} o grpc_json_transcode_failure{response_buffer_size_limit_reached} nel campo responseDetails.

Limitazioni

Le seguenti funzionalità gRPC non sono ancora supportate in API Gateway:

• Compressione del payload
• Qualsiasi IDL diverso dai buffer di protocollo

Al momento API Gateway supporta solo i servizi gRPC di Cloud Run.

Passaggi successivi

• Esplora i campioni. L'esempio getting-started-grpc è disponibile su GitHub nelle seguenti lingue:
  • Java
  • Python
  • Ruby
  • Go
  • Node.js
• L'esempio di libreria è disponibile nelle seguenti lingue:
  • Python
  • Java