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. Per ulteriori informazioni, consulta la Panoramica del portale per gli sviluppatori.
Gestione delle API
Endpoints funziona con Extensible Service Proxy (ESP) o Extensible Service Proxy V2 (ESPv2) per fornire la gestione delle API.
Con Endpoints per gRPC, puoi utilizzare le funzionalità di gestione delle API di Endpoints per aggiungere una console API, il monitoraggio, l'hosting, il monitoraggio, l'autenticazione e altro ancora ai tuoi servizi gRPC. Inoltre, dopo aver specificato regole di mappatura speciali, ESP ed ESPv2 traducono JSON RESTful su HTTP in richieste gRPC. Ciò significa che puoi eseguire il deployment di un server gRPC gestito da Endpoints 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 Endpoints 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.
Piattaforme di calcolo supportate
ESP ed ESPv2 sono progetti open source e sono disponibili nei seguenti modi:
- Un contenitore in Artifact Registry.
- Consulta le note di rilascio di ESP per l'immagine Docker ESP corrente.
- Consulta le note di rilascio di ESPv2 per l'immagine Docker ESPv2 corrente.
- Codice sorgente in GitHub.
- Per informazioni dettagliate sulla creazione di ESP, consulta il file README di ESP.
- Per informazioni dettagliate sulla creazione di ESPv2, consulta il file README di ESPv2.
Puoi eseguire il contenitore ESP su quanto segue:
- Compute Engine con Docker
- Kubernetes, incluso Google Kubernetes Engine
- Un computer Linux o macOS o un altro provider cloud
Puoi eseguire il contenitore ESPv2 su quanto segue:
- Cloud Run
- Knative serving
- GKE
- Compute Engine
- Kubernetes
Per saperne di più, consulta Informazioni su Cloud Endpoints.
Consulta Eseguire il deployment del backend dell'API per informazioni su come eseguire il deployment dell'API e Extensible Service Proxy sulle piattaforme di calcolo Google Cloud.
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 Endpoints, 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 Cloud Endpoints.
Transcodifica
Endpoints fornisce la traduzione del protocollo per i tuoi servizi gRPC, consentendo ai client di utilizzare HTTP/JSON per comunicare con un servizio gRPC tramite ESP o ESPv2.
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. Endpoints 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.
Limitazioni
Le seguenti funzionalità gRPC non sono ancora supportate in Endpoints:
- Compressione del payload
- Qualsiasi IDL diverso dai buffer di protocollo
Inoltre, Endpoints supporta solo i servizi gRPC per GKE, Compute Engine e Cloud Run (beta). Endpoints non supporta i servizi gRPC per gli ambienti App Engine.
Passaggi successivi
- Segui uno dei nostri tutorial per configurare un semplice servizio gRPC con Cloud Endpoints nel tuo ambiente preferito
- Scopri come configurare un servizio gRPC per Cloud Endpoints
- Esplora i campioni. L'esempio getting-started-grpc è disponibile su GitHub nelle seguenti lingue:
- L'esempio di libreria è disponibile nelle seguenti lingue: