Verwendung von gRPC mit Distributionen CloudFront

Amazon CloudFront unterstützt gRPC, ein Open-Source-Framework für Remote Procedure Call (RPC), das darauf aufbautHTTP/2. gRPC bietet ein bidirektionales Streaming- und Binärprotokoll, das Nutzlasten zwischenspeichert, sodass es sich für Anwendungen eignet, die eine Kommunikation mit niedriger Latenz erfordern.

CloudFront empfängt Ihre gRPC-Anfragen und leitet sie direkt an Ihre Ursprünge weiter. Sie können vier Arten von CloudFront gRPC-Diensten als Proxy verwenden:

• Unäres RPC

• Server-Streaming-RPC

• Client-Streaming-RPC

• Bi-directional Streaming-RPC

Wie funktioniert gRPC in CloudFront

Um gRPC zu konfigurieren CloudFront, legen Sie einen Ursprung, der einen gRPC-Dienst bereitstellt, als Ursprung Ihrer Distribution fest. Sie können Origins verwenden, die sowohl Nicht-gRPC- als auch gRPC-Dienste bereitstellen. CloudFront bestimmt, ob es sich bei der eingehenden Anfrage um eine gRPC-Anfrage handelt oder um eine HTTP/HTTPS Anfrage, die auf dem Header basiert. Content-Type Wenn der Content-Type Header einer Anfrage den Wert von hatapplication/grpc, wird die Anfrage als gRPC-Anfrage betrachtet und leitet CloudFront die Anfrage an Ihren Ursprung weiter.

Anmerkung

Damit eine Distribution gRPC-Anfragen verarbeiten kann, fügen Sie sie HTTP/2 als eine der unterstützten HTTP-Versionen hinzu und lassen Sie HTTP-Methoden zu, einschließlich. POST Ihr gRPC-Ausgangsendpunkt muss so konfiguriert sein, dass er HTTPS unterstützt, da CloudFront nur secure (HTTPS-based) gRPC-Verbindungen unterstützt werden. gRPC unterstützt nur Ende-zu-Ende-HTTPS. Wenn Sie einen benutzerdefinierten Ursprung verwenden, stellen Sie sicher, dass Ihre Protokolleinstellungen HTTPS unterstützen.

Um die gRPC-Unterstützung für Ihre Distribution zu aktivieren, führen Sie die folgenden Schritte aus:

1. Aktualisieren Sie das Cacheverhalten Ihrer Distribution, um HTTP-Methoden, einschließlich der POST-Methode, zuzulassen.

2. Wählen Sie nach Auswahl der POST-Methode das angezeigte gRPC-Kontrollkästchen aus.

3. Geben Sie HTTP/2 als eine der unterstützten HTTP-Versionen an.

Weitere Informationen finden Sie unter den folgenden Themen:

• Erlaube gRPC-Anfragen HTTP/2

• GrpcConfigin der CloudFront Amazon-API-Referenz

Da gRPC nur für API-Verkehr verwendet wird, der nicht zwischengespeichert werden kann, wirken sich Ihre Cache-Konfigurationen nicht auf gRPC-Anforderungen aus. Sie können eine Ursprungsanforderungsrichtlinie verwenden, um den gRPC-Anforderungen, die an Ihren gRPC-Ursprung gesendet werden, benutzerdefinierte Header hinzuzufügen. Sie können AWS WAF with verwenden CloudFront , um den Zugriff auf Ihre gRPC-Distribution zu verwalten, Bots zu kontrollieren und Ihre gRPC-Anwendungen vor Web-Exploits zu schützen. CloudFront gRPC unterstützt Funktionen. CloudFront

Zusätzlich zum HTTPS-Status erhalten Sie zusammen mit Ihrer gRPC-Antwort den gRPC-Status. Eine Liste möglicher Werte für gRPC-Status finden Sie unter Statuscodes und ihre Verwendung in gRPC.

Hinweise

gRPC unterstützt die folgenden CloudFront Funktionen nicht:

• Benutzerdefinierte Fehlerantworten

• Origin-Failover wird mit gRPC nicht unterstützt, da gRPC die Methode verwendet. POST CloudFront Failover zum sekundären Ursprung erfolgt nur, wenn die HTTP-Methode der Viewer-Anfrage aufGET, HEAD oder gesetzt ist. OPTIONS

• CloudFront leitet gRPC-Anfragen direkt an den Ursprung weiter und umgeht den Regional Edge Cache (REC). Da gRPC den REC umgeht, unterstützt gRPC weder Lambda@Edge noch Origin Shield.

• gRPC unterstützt AWS WAF keine Regeln für die Inspektion von Anfragen. Wenn Sie diese Regeln in der Web-ACL für eine Distribution aktiviert haben, ignoriert jede Anforderung, die gRPC verwendet, die Regeln zur Überprüfung des Anforderungstexts. Alle anderen AWS WAF -Regeln gelten weiterhin. Weitere Informationen finden Sie unter Aktivieren von AWS WAF für Distributionen.