Menyiapkan backend eksternal dengan NEG internet

Panduan ini menggunakan contoh untuk menjelaskan dasar-dasar penggunaan backend eksternal (terkadang disebut asal kustom) di Load Balancer Aplikasi eksternal. Backend eksternal adalah endpoint yang bersifat eksternal terhadap Google Cloud. Saat menggunakan backend eksternal dengan Load Balancer Aplikasi eksternal, Anda dapat meningkatkan performa dengan menggunakan cache Cloud CDN.

Panduan ini menjelaskan langkah-langkah cara mengonfigurasi Load Balancer Aplikasi eksternal global dengan layanan backend yang mendukung Cloud CDN yang melakukan proxy ke server backend eksternal di backend.example.com.

Dalam contoh ini, load balancer menerima permintaan HTTPS dari klien dan membuat proxy permintaan ini sebagai HTTPS ke backend eksternal. Contoh ini mengasumsikan bahwa backend eksternal mendukung HTTPS.

Opsi lainnya adalah mengonfigurasi load balancer untuk menerima permintaan HTTP atau HTTPS, dan menggunakan HTTPS saat melakukan proxy permintaan ke backend eksternal.

Panduan ini mengasumsikan bahwa Anda telah menyiapkan load balancer dan Anda menambahkan backend eksternal baru. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Load Balancer Aplikasi klasik dengan backend grup instance terkelola.

Gambar 1 menunjukkan contoh arsitektur.

Gambar 1. Kasus penggunaan umum untuk backend eksternal.

Dalam diagram, www.example.com memiliki frontend load balancer dengan alamat IP 120.1.1.1. Jika cache tidak ditemukan, permintaan pengguna untuk /cart/id/1223515 akan diambil dari backend eksternal melalui HTTPS. Semua traffic masuk lainnya diarahkan ke layanan backend Google Cloud dengan VM Compute Engine atau ke bucket backend, berdasarkan peta URL.

Sebelum memulai

Sebelum mengikuti panduan ini, pahami hal-hal berikut:

• Ringkasan grup endpoint jaringan internet, yang mencakup batasan.

• Backend eksternal yang ditentukan menggunakan NEG internet

Izin

Untuk mengikuti panduan ini, Anda perlu membuat grup endpoint jaringan internet (NEG) dan membuat atau mengubah Load Balancer Aplikasi eksternal dalam sebuah project. Anda harus menjadi pemilik atau editor project, atau memiliki kedua peran IAM Compute Engine berikut.

Tugas	Peran yang diperlukan
Membuat dan mengubah komponen load balancer	Admin Jaringan
Membuat dan mengubah NEG	Compute Instance Admin

Mengonfigurasi load balancer dengan backend eksternal

Bagian ini menunjukkan cara mengonfigurasi dan menguji NEG internet.

Ringkasan penyiapan

Menyiapkan NEG internet memerlukan hal berikut:

• Menentukan endpoint internet di NEG internet.
• Menambahkan NEG internet sebagai backend ke layanan backend.
• Menentukan traffic pengguna mana yang akan dipetakan ke layanan backend ini dengan mengonfigurasi peta URL Load Balancer Aplikasi eksternal Anda.
• Mengizinkan rentang IP yang diperlukan.

Contoh ini membuat resource berikut:

• Aturan penerusan dengan alamat IP 120.1.1.1 mengarahkan permintaan masuk ke proxy target.
• networkTier aturan penerusan harus berupa PREMIUM.
• Proxy target memeriksa setiap permintaan di peta URL guna menentukan layanan backend yang sesuai untuk permintaan.
• Untuk backend eksternal, proxy target harus berupa TargetHttpProxy atau TargetHttpsProxy. Contoh ini menggunakan TargetHttpsProxy.
• Cloud CDN diaktifkan (opsional) di layanan backend memungkinkan penyimpanan dalam cache dan penayangan respons dari cache Cloud CDN.
• Contoh ini mencakup header kustom, yang diperlukan saat backend eksternal mengharapkan nilai tertentu untuk header Host permintaan HTTP.

Penyiapannya akan terlihat seperti berikut.

Gambar 2. Cloud CDN dengan backend on-premise.

Membuat NEG dan endpoint internet

Konsol

1. Di Konsol Google Cloud, buka halaman Network endpoint groups.

   Buka Network endpoint groups

2. Klik Create network endpoint group.
3. Masukkan nama grup endpoint jaringan: example-fqdn-neg.
4. Untuk Network endpoint group type, pilih Network endpoint group (Internet).
5. Untuk Port default, masukkan 443.
6. Untuk New network endpoint, pilih Fully qualified domain name and port.
7. Untuk FQDN, masukkan backend.example.com.
8. Untuk Jenis port, pilih Default, dan pastikan Nomor port adalah 443.
9. Klik Create.

gcloud

1. Buat NEG internet, dan tetapkan --network-endpoint-type ke internet-fqdn-port (nama host dan port tempat backend eksternal Anda dapat dijangkau):

   gcloud compute network-endpoint-groups create example-fqdn-neg \
       --network-endpoint-type="internet-fqdn-port" --global
   

2. Tambahkan endpoint Anda ke NEG. Jika port tidak ditentukan, pemilihan port akan ditetapkan secara default ke port 80 (HTTP) atau 443 (HTTPS; HTTP/2) bergantung pada protokol yang dikonfigurasi di layanan backend. Pastikan untuk menyertakan flag --global:

   gcloud compute network-endpoint-groups update example-fqdn-neg \
       --add-endpoint="fqdn=backend.example.com,port=443" \
       --global
   

3. Cantumkan NEG internet yang dibuat:

   gcloud compute network-endpoint-groups list --global
   

   Output:

   NAME                LOCATION   ENDPOINT_TYPE        SIZE
   example-fqdn-neg    global     INTERNET_FQDN_PORT   1
   

4. Cantumkan endpoint dalam NEG tersebut:

   gcloud compute network-endpoint-groups list-network-endpoints example-fqdn-neg \
       --global
   

   Output:

   INSTANCE   IP_ADDRESS   PORT   FQDN
                                  backend.example.com
   

Menambahkan backend eksternal ke load balancer

Contoh berikut memperbarui load balancer yang ada.

Di load balancer yang ada, layanan default adalah layanan Google Cloud. Contoh ini mengubah peta URL yang ada dengan menambahkan pencocok jalur yang mengirim semua permintaan untuk cart/id/1223515 ke layanan backend images, yang dikaitkan dengan NEG internet.

Konsol

Buat layanan backend dan tambahkan NEG internet

1. Di konsol Google Cloud, buka halaman Load balancing.

   Buka Load balancing

2. Untuk menambahkan layanan backend ke load balancer yang ada, pilih Load Balancer Aplikasi klasik, klik Menu, lalu pilih Edit.
3. Klik Backend configuration.
4. Di menu Backend services & backend buckets, pilih Create a backend service.
5. Tetapkan nama layanan backend ke images.
6. Untuk Backend type, pilih Internet network endpoint group.
7. Pilih protokol yang ingin Anda gunakan dari load balancer ke NEG internet. Untuk contoh ini, pilih HTTPS.
8. Di bagian New backend > Internet network endpoint group, pilih example-fqdn-neg, lalu klik Done.
9. Pilih Enable Cloud CDN.
10. Opsional: Ubah setelan mode cache dan TTL.
11. Di Advanced configurations, pada bagian Custom request headers, klik Add header.
    1. Untuk Header name, masukkan Host.
    2. Untuk Header value, masukkan backend.example.com.
12. Klik Create.
13. Biarkan jendela tetap terbuka untuk melanjutkan.

Melampirkan layanan backend ke peta URL yang ada

1. Klik Host and path rules.
2. Baris pertama memiliki layanan Google Cloud di kolom kanan, dan salah satunya sudah diisi dengan aturan default Any unmatched (default) untuk Host dan Jalur.
3. Pastikan ada baris dengan images yang dipilih di kolom kanan. Jika tidak ada, klik Tambahkan host dan aturan jalur, lalu pilih images. Isi kolom lainnya sebagai berikut:
   1. Di Hosts, masukkan *.
   2. Di Paths, masukkan /cart/id/1223515.

Tinjau dan selesaikan

1. Klik Review and finalize.
2. Bandingkan setelan Anda dengan yang ingin Anda buat.
3. Jika semuanya sudah benar, klik Perbarui.

gcloud

1. Buat layanan backend baru untuk NEG:

   gcloud compute backend-services create images \
      --global \
      --enable-cdn \
      --cache-mode=CACHE_MODE \
      --protocol=HTTP2
   

   Tetapkan mode cache dengan mengganti CACHE_MODE dengan salah satu dari yang berikut ini:

   • CACHE_ALL_STATIC: otomatis meng-cache konten statis

   • USE_ORIGIN_HEADERS (default): mewajibkan origin menetapkan header cache yang valid untuk meng-cache konten

   • FORCE_CACHE_ALL: menyimpan semua konten dalam cache, mengabaikan perintah private, no-store, atau no-cache dalam header respons Cache-Control

2. Konfigurasikan layanan backend untuk menambahkan header permintaan kustom Host: backend.example.com ke permintaan:

   gcloud compute backend-services update images \
      --custom-request-header "Host: backend.example.com" --global
   

3. Gunakan perintah backend-services add-backend untuk menambahkan NEG internet ke layanan backend:

   gcloud compute backend-services add-backend images \
     --network-endpoint-group "example-fqdn-neg" \
     --global-network-endpoint-group \
     --global
   

4. Lampirkan layanan backend baru ke peta URL load balancer dengan membuat aturan pencocokan baru untuk mengarahkan permintaan ke backend tersebut:

   gcloud compute url-maps add-path-matcher EXAMPLE_URL_MAP \
     --default-service=GCP_SERVICE_EXAMPLE \
     --path-matcher-name=CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE \
     --backend-service-path-rules=/CART/ID/1223515=IMAGES
   

   Ganti kode berikut:

   • EXAMPLE_URL_MAP: nama peta URL yang ada
   • GCP_SERVICE_EXAMPLE: nama layanan backend default yang ada
   • CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE: nama aturan jalur baru ini
   • /CART/ID/1223515: jalur
   • IMAGES: nama layanan backend baru dengan NEG internet terlampir

Menambahkan rentang IP yang diperlukan ke daftar yang diizinkan

Agar Load Balancer Aplikasi eksternal dapat mengirim permintaan ke NEG internet, Anda harus mengkueri data TXT DNS _cloud-eoips.googleusercontent.com menggunakan alat seperti dig atau nslookup.

Misalnya, jalankan perintah dig berikut:

dig TXT _cloud-eoips.googleusercontent.com | grep -Eo 'ip4:[^ ]+' | cut -d':' -f2

Outputnya berisi dua rentang IP, sebagai berikut:

34.96.0.0/20
34.127.192.0/18

Perhatian: Rentang IP ini dapat berubah sewaktu-waktu.

Perhatikan rentang IP dan pastikan rentang ini diizinkan oleh firewall atau daftar kontrol akses cloud (ACL) Anda.

Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi permintaan.

Menghubungkan domain ke load balancer

Setelah load balancer dibuat, catat alamat IP yang terkait dengan load balancer, misalnya, 30.90.80.100. Untuk mengarahkan domain ke load balancer, buat data A menggunakan layanan pendaftaran domain. Jika Anda menambahkan beberapa domain ke sertifikat SSL, Anda harus menambahkan data A untuk setiap domain, yang semuanya mengarah ke alamat IP load balancer. Misalnya, untuk membuat data A bagi www.example.com dan example.com, gunakan string berikut:

NAME                  TYPE     DATA
www                   A        30.90.80.100
@                     A        30.90.80.100

Jika Anda menggunakan Cloud DNS sebagai penyedia DNS, lihat Menambahkan, mengubah, dan menghapus data.

Menguji Load Balancer Aplikasi eksternal

Catatan: Mungkin perlu waktu beberapa menit hingga konfigurasi load balancer diterapkan secara global setelah Anda pertama kali men-deploy-nya.

Setelah mengonfigurasi load balancer, Anda dapat mulai mengirimkan traffic ke alamat IP load balancer. Jika mengonfigurasi domain, Anda juga dapat mengirim traffic ke nama domain. Namun, perlu waktu untuk menyelesaikan penyebaran DNS sehingga Anda dapat memulai dengan menggunakan alamat IP untuk pengujian.

1. Di konsol Google Cloud, buka halaman Load balancing.

   Buka Load balancing

2. Klik load balancer yang baru saja Anda buat.

3. Catat alamat IP load balancer.

4. Jika membuat load balancer HTTP, Anda dapat menguji load balancer menggunakan browser web di http://IP_ADDRESS. Ganti IP_ADDRESS dengan alamat IP load balancer. Anda akan diarahkan ke halaman beranda layanan helloworld.

   Jika membuat load balancer HTTPS, Anda dapat menguji load balancer menggunakan browser web di https://IP_ADDRESS. Ganti IP_ADDRESS dengan alamat IP load balancer. Anda akan diarahkan ke halaman beranda layanan helloworld.

   Jika tidak berhasil dan Anda menggunakan sertifikat yang dikelola Google, confirmasikan bahwa status resource sertifikat Anda AKTIF. Untuk informasi selengkapnya, lihat Status resource sertifikat SSL yang dikelola Google.

   Atau, Anda dapat menggunakan curl dari command line komputer lokal. Ganti IP_ADDRESS dengan alamat IPv4 load balancer.

   Jika Anda menggunakan sertifikat yang dikelola Google, uji domain yang mengarah ke alamat IP load balancer. Contoh:

   curl -s 'https://www.example.com:443' --resolve www.example.com:443:IP_ADDRESS
   

5. Opsional: Jika menggunakan domain kustom, Anda mungkin perlu menunggu setelan DNS yang diperbarui diterapkan. Kemudian, uji domain Anda (misalnya, backend.example.com) di browser web.

   Untuk mendapatkan bantuan terkait pemecahan masalah, lihat Memecahkan masalah backend eksternal dan masalah NEG internet.

Menonaktifkan Cloud CDN

Konsol

1. Di konsol Google Cloud, buka halaman Load balancing.

   Buka Load balancing.

2. Klik nama load balancer yang ingin diubah.

3. Klik Edit.

4. Klik Backend configuration.

5. Untuk layanan backend dengan backend NEG internet, klik Edit.

6. Hapus centang pada kotak Enable Cloud CDN.

7. Untuk meninjau perubahan, klik Tinjau dan selesaikan, lalu klik Perbarui.

gcloud

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --no-enable-cdn

Menonaktifkan Cloud CDN tidak akan membatalkan validasi atau menghapus cache. Jika Anda menonaktifkan dan mengaktifkan kembali Cloud CDN, sebagian besar atau semua konten yang disimpan dalam cache mungkin masih di-cache. Untuk mencegah konten digunakan oleh cache, Anda harus membatalkan konten tersebut.

Langkah selanjutnya

• Untuk memeriksa apakah Cloud CDN menayangkan respons dari cache, lihat Log dan metrik untuk penyimpanan dalam cache.
• Untuk mempelajari konten yang dapat di-cache atau tidak dapat di-cache, lihat Ringkasan penyimpanan dalam cache.
• Untuk menemukan lokasi kehadiran GFE, lihat Lokasi cache.