Utilizzo di gRPC con le distribuzioni CloudFront

Amazon CloudFront supporta gRPC, un framework open source basato su Remote Procedure Call (RPC)HTTP/2. gRPC offre streaming bidirezionale e protocollo binario che bufferizza i payload, rendendolo adatto per applicazioni che richiedono comunicazioni a bassa latenza.

CloudFront riceve le tue richieste gRPC e le invia direttamente alle tue origini. È possibile utilizzare CloudFront per eseguire il proxy quattro tipi di servizi gRPC:

• RPC unario

• Streaming del server RPC

• Streaming del client RPC

• Bi-directional streaming RPC

Come funziona gRPC in CloudFront

Per configurare gRPC in CloudFront, imposta un'origine che fornisca un servizio gRPC come origine della tua distribuzione. È possibile utilizzare origini che forniscono servizi non gRPC e gRPC. CloudFront determina se la richiesta in arrivo è una richiesta gRPC o una HTTP/HTTPS richiesta basata sull'intestazione. Content-Type Se l'Content-Typeintestazione di una richiesta ha il valore diapplication/grpc, la richiesta viene considerata una richiesta gRPC e CloudFront invierà la richiesta all'origine.

Nota

Per consentire a una distribuzione di gestire le richieste gRPC, includetela HTTP/2 come una delle versioni HTTP supportate e consentite i metodi HTTP, tra cui. POST L'endpoint di origine gRPC deve essere configurato per supportare HTTPS, poiché supporta CloudFront solo connessioni gRPC sicure (HTTPS-based). gRPC supporta solo HTTPS end-to-end. Se utilizzi un’origine personalizzata, verifica che le impostazioni Protocollo supportino HTTPS.

Per abilitare il supporto gRPC per la distribuzione, completa le seguenti fasi:

1. Aggiorna il comportamento cache della distribuzione per consentire i metodi HTTP, incluso il metodo POST.

2. Dopo aver selezionato il metodo POST, seleziona la casella di controllo gRPC che viene visualizzata.

3. Specifica HTTP/2 come una delle versioni HTTP supportate.

Per ulteriori informazioni, consulta i seguenti argomenti:

• Consenti il superamento delle richieste gRPC HTTP/2

• GrpcConfignell'Amazon CloudFront API Reference

Poiché gRPC è utilizzato solo per traffico API non memorizzabile nella cache, le configurazioni della cache non influiranno sulle richieste gRPC. Puoi usare una policy di richiesta di origine per aggiungere intestazioni personalizzate alle richieste gRPC inviate alla all’origine gRPC. Puoi utilizzarlo CloudFront per AWS WAF gestire l'accesso alla tua distribuzione gRPC, controllare i bot e proteggere le tue applicazioni gRPC dagli exploit web. CloudFront gRPC supporta le funzioni. CloudFront

Oltre allo stato HTTPS, riceverai grpc-status insieme alla risposta gRPC. Per un elenco dei valori possibili per grpc-status, consulta Codici di stato e loro utilizzo in gRPC.

Note

gRPC non supporta le seguenti funzionalità: CloudFront

• Risposte di errore personalizzate

• Il failover di origine non è supportato con gRPC, poiché gRPC utilizza il metodo. POST CloudFront esegue il failover sull'origine secondaria solo quando il metodo HTTP della richiesta del visualizzatore èGET,, HEAD o. OPTIONS

• CloudFront invia le richieste gRPC direttamente all'origine e ignora la Regional Edge Cache (REC). Poiché gRPC aggira il REC, gRPC non supporta Lambda@Edge o Origin Shield.

• gRPC non supporta le regole di ispezione degli organismi di richiesta. AWS WAF Se hai abilitato queste regole sull’ACL Web per una distribuzione, qualsiasi richiesta che utilizza gRPC ignorerà le regole di ispezione del corpo della richiesta. Tutte le altre regole AWS WAF continueranno ad essere applicate. Per ulteriori informazioni, consulta Abilitazione di AWS WAF per le distribuzioni.