gRPC è un framework RPC universale open source ad alte prestazioni sviluppato da Google. In gRPC, un'applicazione client può chiamare direttamente i metodi di un'applicazione server su un'altra macchina come se si trattasse di un oggetto locale, semplificando la creazione di applicazioni e servizi distribuiti.
Uno dei principali vantaggi dell'utilizzo di gRPC è la documentazione: puoi utilizzare la configurazione del servizio e i file di definizione dell'interfaccia API per generare la 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, monitoraggio, hosting, tracciamento, autenticazione e altro ancora ai tuoi servizi gRPC. Inoltre, una volta specificate le regole di mappatura speciali, ESP ed ESPv2 traducono RESTful JSON 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, offrendoti maggiore flessibilità e facilità di integrazione con altri sistemi.
Puoi creare servizi gRPC per Endpoints in qualsiasi linguaggio supportato da gRPC. Ulteriori informazioni su gRPC, tra cui guide rapide e tutorial per la creazione di server e client, sono disponibili sul sito di gRPC.
Piattaforme di computing supportate
ESP ed ESPv2 sono progetti open source e sono disponibili nei seguenti modi:
- Un container in Google Container Registry.
- Consulta le note di rilascio di ESP per l'immagine Docker ESP attuale.
- Consulta le note di rilascio di ESPv2 per l'immagine Docker ESPv2 attuale.
- Codice sorgente in GitHub.
- Consulta il README ESP per i dettagli sulla creazione di ESP.
- Consulta il README DI ESPv2 per i dettagli sulla creazione di ESPv2.
Puoi eseguire il container ESP su:
- Compute Engine con Docker
- Kubernetes, incluso Google Kubernetes Engine
- Un computer Linux o macOS o un altro cloud provider
Puoi eseguire il container ESPv2 su:
- Cloud Run
- Cloud Run for Anthos
- GKE
- Compute Engine
- Kubernetes
Per saperne di più, consulta Informazioni su Cloud Endpoints.
Consulta Deployment del backend dell'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 da remoto con i relativi parametri e i tipi restituiti. Per impostazione predefinita, gRPC utilizza i buffer di protocollo come IDL (Interface Definition Language) 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, incluse autenticazione, API incluse nel servizio, mappature dalle richieste HTTP ai metodi gRPC e 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 attraverso ESP o ESPv2.
Il caso d'uso più comune è consentire ai client browser di comunicare con i server gRPC senza supporto speciale dalle librerie client gRPC. Gli endpoint forniscono un meccanismo per mappare le richieste HTTP ai metodi gRPC nell'ambito della configurazione del servizio.
Puoi scoprire di più in merito nell'articolo Transcodifica di HTTP/JSON in gRPC.
Limitazioni
Le seguenti funzionalità gRPC non sono ancora supportate in Endpoints:
- Compressione 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 eseguire 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 Getting-started-grpc è disponibile su GitHub nei seguenti linguaggi:
- L'anteprima di Bookstore è disponibile nelle seguenti lingue: