View a markdown version of this page

Menggunakan gRPC dengan distribusi CloudFront - Amazon CloudFront
Bagaimana gRPC bekerja di CloudFront

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

Amazon CloudFront mendukung gRPC, kerangka kerja panggilan prosedur jarak jauh (RPC) sumber terbuka yang dibangun di atasnyaHTTP/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 memproxynya langsung ke asal Anda. Anda dapat menggunakan CloudFront untuk proxy empat jenis layanan gRPC:

  • RPC tunggal

  • RPC Streaming Server

  • RPC streaming klien

  • Bi-directional streaming RPC

Bagaimana gRPC bekerja di CloudFront

Untuk mengonfigurasi gRPC di 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 masuk adalah permintaan gRPC atau HTTP/HTTPS permintaan berdasarkan Content-Type header. Jika Content-Type header permintaan memiliki nilaiapplication/grpc, permintaan tersebut dianggap sebagai permintaan gRPC dan CloudFront akan memproksi permintaan 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, termasukPOST. 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 asal khusus, verifikasi bahwa pengaturan Protokol 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.

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

  3. Tentukan HTTP/2 sebagai salah satu versi HTTP yang didukung.

Untuk informasi selengkapnya, lihat topik berikut:

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 khusus ke permintaan gRPC yang dikirim ke asal gRPC Anda. Anda dapat menggunakan AWS WAF dengan CloudFront untuk mengelola akses ke distribusi gRPC Anda, mengontrol bot, dan melindungi aplikasi gRPC Anda dari eksploitasi web. CloudFront gRPC mendukung CloudFront Fungsi.

Selain status HTTPS, Anda akan menerima status grpc bersama dengan respons gRPC Anda. Untuk daftar nilai yang mungkin untuk status grpc, lihat Kode status dan penggunaannya di gRPC.

Catatan

gRPC tidak mendukung fitur- CloudFront fitur berikut:

  • Respons kesalahan khusus

  • Failover asal tidak didukung dengan gRPC, karena gRPC menggunakan metode. POST CloudFront gagal beralih ke asal sekunder hanya ketika metode HTTP dari permintaan penampil adalahGET,HEAD, atauOPTIONS.

  • CloudFront proxy meminta gRPC langsung ke asal dan melewati Regional Edge Cache (REC). Karena gRPC melewati REC, gRPC tidak mendukung Lambda @Edge atau Origin Shield. Gunakan Amazon CloudFront Origin Shield

  • gRPC tidak mendukung aturan pemeriksaan 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 lainnya akan tetap berlaku. Lihat informasi yang lebih lengkap di Aktifkan AWS WAF untuk distribusi.