gRPC è un framework RPC universale open source ad alte prestazioni sviluppato da Google. In gRPC, un'applicazione client può chiamare direttamente i metodi su un'applicazione server su una macchina diversa come se fosse un oggetto locale, semplificando la creazione di applicazioni e servizi distribuiti.
Uno dei principali vantaggi dell'uso di gRPC è per la documentazione: puoi utilizzare i file di configurazione del servizio e di definizione dell'interfaccia API per generare documentazione di riferimento per l'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 tracciamento, l'autenticazione e altro ancora ai tuoi servizi gRPC. Inoltre, una volta specificate regole di mappatura speciali, ESP ed ESPv2 traducono il file JSON RESTful su HTTP in richieste gRPC. Ciò significa che puoi eseguire il deployment di un server gRPC gestito da endpoint e chiamare la relativa API utilizzando un client gRPC o JSON/HTTP, offrendo maggiore flessibilità e facilità di integrazione con altri sistemi.
Puoi creare servizi gRPC per Endpoints in qualsiasi linguaggio supportato da gRPC. Per saperne di più su gRPC, tra cui guide rapide e tutorial per la creazione di server e client, visita il sito gRPC.
Piattaforme di computing supportate
ESP ed ESPv2 sono progetti open source disponibili nei seguenti modi:
- Un container in Google Container Registry.
- Consulta le note di rilascio di ESP per l'immagine Docker di ESP attuale.
- Consulta le note di rilascio di ESPv2 per l'immagine Docker ESPv2 attuale.
- Codice sorgente in GitHub.
- Consulta il README DI ESP per i dettagli sulla creazione di ESP.
- Consulta il file README di ESPv2 per i dettagli sulla creazione di ESPv2.
Puoi eseguire il container ESP su questi elementi:
- Compute Engine con Docker
- Kubernetes, compreso Google Kubernetes Engine
- Un computer Linux o macOS o un altro provider cloud
Puoi eseguire il container ESPv2 su quanto segue:
- Cloud Run
- Knative serving
- GKE
- Compute Engine
- Kubernetes
Per ulteriori informazioni, consulta Informazioni su Cloud Endpoints.
Consulta Deployment del backend delle API per informazioni sul deployment di API ed ESP sulle piattaforme di computing Google Cloud.
Definizione e configurazione del servizio
gRPC si basa sull'idea di definire un servizio, specificando i metodi che possono essere chiamati in remoto con i relativi parametri e tipi restituiti. Per impostazione predefinita, gRPC utilizza buffer di protocollo come Interface Definition Language (IDL) per descrivere sia l'interfaccia di servizio sia la struttura dei messaggi di 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. Questa operazione consente di configurare il comportamento di runtime del tuo servizio, incluse l'autenticazione, le API incluse nel servizio, le mappature delle richieste HTTP ai metodi gRPC e le impostazioni speciali degli endpoint Cloud.
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 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 come parte della configurazione del servizio.
Puoi trovare ulteriori informazioni in merito 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.
Che cosa succede dopo?
- Segui uno dei nostri tutorial per configurare e utilizzare un semplice servizio gRPC con Cloud Endpoints nell'ambiente che preferisci
- Scopri come configurare un servizio gRPC per Cloud Endpoints
- Esplora gli esempi. L'esempio get-started-grpc è disponibile su GitHub nelle seguenti lingue:
- L'anteprima della libreria è disponibile nelle seguenti lingue: