

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan gRPC dengan distribusi CloudFront
<a name="distribution-using-grpc"></a>

Amazon CloudFront mendukung gRPC, kerangka kerja panggilan prosedur jarak jauh sumber terbuka (RPC) bawaan. HTTP/2 gRPC menawarkan streaming dua arah dan protokol biner yang menyangga muatan, sehingga cocok untuk aplikasi yang memerlukan komunikasi latensi rendah.

CloudFront menerima permintaan gRPC Anda dan memproksinya langsung ke asal Anda. Anda dapat menggunakan CloudFront untuk mem-proxy empat jenis layanan gRPC:
+ RPC Unary
+ Server streaming RPC
+ Klien streaming RPC
+ Bi-directional streaming RPC

## Bagaimana gRPC bekerja di CloudFront
<a name="how-grpc-works-cloudfront"></a>

Untuk mengonfigurasi gRPC CloudFront, tetapkan asal yang menyediakan layanan gRPC sebagai asal distribusi Anda. Anda dapat menggunakan asal yang menyediakan layanan non-gRPC dan gRPC. CloudFront menentukan apakah permintaan yang masuk adalah permintaan gRPC atau HTTP/HTTPS permintaan berdasarkan `Content-Type` header. Jika `Content-Type` header permintaan memiliki nilai`application/grpc`, permintaan tersebut dianggap sebagai permintaan gRPC dan CloudFront akan mem-proxy permintaan tersebut ke asal Anda.

**catatan**  
Untuk mengaktifkan distribusi untuk menangani permintaan gRPC, sertakan HTTP/2 sebagai salah satu versi HTTP yang didukung, dan izinkan metode HTTP, termasuk. `POST` Titik akhir asal gRPC Anda harus dikonfigurasi untuk mendukung HTTPS, karena CloudFront hanya mendukung koneksi gRPC aman (). HTTPS-based gRPC hanya mendukung HTTPS ujung ke ujung. Jika Anda menggunakan custom origin, verifikasi bahwa setelan [Protokol](DownloadDistValuesOrigin.md#DownloadDistValuesOriginProtocolPolicy) Anda mendukung HTTPS.

Untuk mengaktifkan dukungan gRPC untuk distribusi Anda, selesaikan langkah-langkah berikut:

1. Perbarui perilaku cache distribusi Anda untuk mengizinkan metode HTTP, termasuk `POST` metode.

1. Setelah Anda memilih `POST` metode, pilih kotak centang gRPC yang muncul.

1. Tentukan **HTTP/2**sebagai salah satu versi HTTP yang didukung. 

Untuk informasi selengkapnya, lihat topik berikut:
+ [Izinkan permintaan gRPC berakhir HTTP/2](DownloadDistValuesCacheBehavior.md#enable-grpc-distribution)
+ [GrpcConfig](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GrpcConfig.html)di *Referensi CloudFront API Amazon*

Karena gRPC hanya digunakan untuk lalu lintas API yang tidak dapat di-cache, konfigurasi cache Anda tidak akan memengaruhi permintaan gRPC. Anda dapat menggunakan kebijakan permintaan asal untuk menambahkan header kustom ke permintaan gRPC yang dikirim ke asal gRPC Anda. Anda dapat menggunakannya AWS WAF CloudFront untuk mengelola akses ke distribusi gRPC Anda, mengontrol bot, dan melindungi aplikasi gRPC Anda dari eksploitasi web. CloudFront [gRPC mendukung CloudFront Fungsi.](cloudfront-functions.md)

Selain status HTTPS, Anda akan menerima status grpc bersama dengan respons gRPC Anda. Untuk daftar kemungkinan nilai grpc-status, lihat [Kode status dan penggunaannya di](https://grpc.github.io/grpc/core/md_doc_statuscodes.html) gRPC.

**Catatan**  
gRPC tidak mendukung fitur-fitur berikut: CloudFront   
[Tanggapan kesalahan kustom](GeneratingCustomErrorResponses.md)
 [Origin failover](high_availability_origin_failover.md) tidak didukung dengan gRPC, karena gRPC menggunakan metode. `POST` CloudFront gagal ke asal sekunder hanya jika metode HTTP dari permintaan penampil adalah`GET`,`HEAD`, atau`OPTIONS`.
CloudFront proxy gRPC meminta langsung ke asal dan melewati Regional Edge Cache (REC). [Karena gRPC melewati REC, gRPC tidak [mendukung Lambda](lambda-at-the-edge.md) @Edge atau Origin Shield.](origin-shield.md)
gRPC tidak mendukung aturan inspeksi badan AWS WAF permintaan. Jika Anda mengaktifkan aturan ini di ACL web untuk distribusi, permintaan apa pun yang menggunakan gRPC akan mengabaikan aturan inspeksi badan permintaan. Semua AWS WAF aturan lain akan tetap berlaku. Lihat informasi yang lebih lengkap di [Aktifkan AWS WAF untuk distribusi](WAF-one-click.md).