Cara merutekan permintaan

ID region

REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.

Pelajari ID region lebih lanjut.

Halaman ini menjelaskan cara permintaan HTTP dari pengguna menjangkau versi layanan yang sesuai. Permintaan dapat dirutekan dengan cara berikut:

Opsi ini hanya berlaku untuk aplikasi yang di-deploy. Saat Anda melakukan pengujian secara lokal, perilaku perutean bergantung pada runtime dan lingkungan pengembangan tertentu yang Anda gunakan.

Perhatikan bahwa jika Anda menggunakan layanan paket lama untuk menguji aplikasi menggunakan server pengembangan lokal, fitur pemilihan rute dan pengiriman yang tersedia akan sedikit berbeda. Untuk membuat URL secara terprogram yang berfungsi dengan server produksi dan pengembangan, gunakan fungsiget_hostname. Lihat pemilihan rute di server pengembangan untuk mempelajari lebih lanjut.

Memilih rute dengan URL

Setelah aplikasi berjalan di App Engine, Anda dapat menggunakan URL berikut untuk mengirim permintaan HTTP ke aplikasi:

https://PROJECT_ID.REGION_ID.r.appspot.com

dengan PROJECT_ID adalah ID project Google Cloud yang berisi aplikasi.

URL ini mengirimkan permintaan ke layanan default aplikasi pada versi yang telah Anda konfigurasi untuk menerima traffic.

URL untuk layanan dan versi

Jika Anda membuat lebih dari satu layanan di aplikasi, setiap layanan memiliki URL-nya sendiri. Setiap versi layanan juga memiliki URL-nya sendiri, sehingga Anda dapat men-deploy dan menguji versi baru sebelum mengonfigurasi versi tersebut untuk menerima traffic.

URL untuk layanan dan versi tertentu ada dalam bentuk berikut:

VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

Anda dapat menghilangkan VERSION-dot- jika tidak perlu menargetkan versi tertentu.

Untuk mengambil ID layanan dan versi aplikasi, Anda dapat menggunakan salah satu alat berikut:

Konsol

Di konsol Google Cloud, Anda dapat melihat halaman Instances, Services, dan Versions yang sesuai.

gcloud

Jalankan perintah gcloud app instances list untuk mencantumkan ID resource dalam project Google Cloud tertentu.

API

Untuk mengambil ID resource secara terprogram, lihat metode list di Admin API.

Contoh URL

Berikut adalah beberapa contoh URL untuk App Engine, yang menunjukkan domain appspot.com yang ditetapkan App Engine untuk aplikasi Anda dan domain kustom yang dapat Anda siapkan untuk aplikasi Anda ini.

  • Mengirim permintaan ke instance layanan default yang tersedia:
    
https://PROJECT_ID.REGION_ID.r.appspot.com
https://CUSTOM_DOMAIN

    Permintaan diterima oleh semua versi yang dikonfigurasi untuk traffic di layanan default.

  • Mengirim permintaan ke instance layanan tertentu yang tersedia:
    
https://SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://SERVICE_ID.CUSTOM_DOMAIN

    Permintaan diterima oleh semua versi yang dikonfigurasi untuk traffic di layanan yang ditargetkan. Jika layanan yang Anda targetkan tidak ada, permintaan akan dirutekan dengan ringan.

  • Mengirim permintaan ke instance yang tersedia dari versi tertentu di
    Layanan default:
    
https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://VERSION_ID.CUSTOM_DOMAIN

    Jika layanan tidak ditargetkan, permintaan akan dikirim ke layanan default.

Pemilihan rute ringan

Jika permintaan cocok dengan bagian PROJECT_ID.REGION_ID.r.appspot.com nama host, tetapi menyertakan layanan, versi, atau nama instance yang tidak ada, permintaan tersebut akan dirutekan ke layanan default. Pemilihan rute ringan tidak berlaku untuk domain kustom; permintaan kepadanya akan menampilkan kode status HTTP 404 jika nama host tidak valid.

Pemilihan rute yang ditargetkan

Pola URL berikut dijamin akan mencapai targetnya, jika ada. Permintaan ini tidak pernah dicegat dan dirutekan ulang oleh pola yang telah Anda tentukan di file dispatch:

  • Mengirim permintaan ke instance layanan dan versi tertentu yang tersedia: 

    
https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://VERSION_ID.SERVICE_ID.PROJECT_ID.CUSTOM_DOMAIN

  • Jika menggunakan layanan yang diskalakan secara manual, Anda dapat menargetkan dan mengirim permintaan ke instance dengan menyertakan ID instance. ID instance adalah bilangan bulat dalam rentang dari 0 hingga jumlah total instance yang berjalan, dan dapat ditentukan sebagai berikut:

    Mengirim permintaan ke layanan dan versi tertentu dalam instance tertentu: 

    https://INSTANCE_ID-dot-VERSION_ID-dot-SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://INSTANCE_ID.VERSION_ID.SERVICE_ID.CUSTOM_DOMAIN

Memilih rute dengan file dispatch

Anda dapat membuat file dispatch untuk mengganti aturan pemilihan rute berbasis URL App Engine dan menentukan aturan pemilihan rute kustom Anda sendiri. Dengan file dispatch, Anda dapat mengirim permintaan masuk ke layanan tertentu berdasarkan jalur atau nama host di URL permintaan.

Membuat file dispatch

Untuk membuat file dispatch, lakukan hal berikut:

  1. Buat file bernama dispatch.yamlBaik di root direktori project Anda, maupun di direktori root layanan default Anda.

  2. Tentukan aturan pemilihan rute dalam file seperti yang dijelaskan, lihat referensi dispatch.yaml.

Perhatikan hal-hal berikut terkait aturan pemilihan rute:

  • Anda dapat menentukan hingga 20 aturan pemilihan rute. Setiap aturan harus berisi elemen url dan service.
  • Aturan tersebut harus menggunakan pola URL HTTP yang menyertakan notasi "." untuk memisahkan subdomain. URL yang ditentukan dengan notasi "-dot-" HTTPS tidak didukung.
  • Aturan ini juga berlaku untuk URL yang Anda tentukan di file cron.yaml.

Misalnya, Anda dapat membuat file dispatch untuk mengarahkan permintaan seluler seperti https://simple-sample.uc.r.appspot.com/mobile/ ke frontend seluler, dan merutekan permintaan pekerja seperti https://simple-sample.uc.r.appspot.com/work/ ke backend statis:

dispatch:
  # Send all mobile traffic to the mobile frontend.
  - url: "*/mobile/*"
    service: mobile-frontend

  # Send all work to the one static backend.
  - url: "*/work/*"
    service: static-backend

Men-deploy file dispatch

Untuk men-deploy file dispatch menggunakan gcloud, jalankan perintah berikut:

gcloud app deploy dispatch.yaml

Pemilihan rute dengan Cloud Load Balancing

Cloud Load Balancing adalah produk terpisah yang memungkinkan konfigurasi jaringan lanjutan untuk semua aplikasi Anda yang berjalan di Google Cloud.

Saat Load Balancing HTTP(S) diaktifkan untuk aplikasi serverless, Anda dapat:

  • Konfigurasi aplikasi serverless untuk menyalurkan dari alamat IP IPv4 dan/atau IPv6 khusus yang tidak digunakan bersama dengan layanan lain.

  • Gunakan kembali sertifikat SSL dan kunci pribadi yang sama dengan yang Anda gunakan untuk Compute Engine, Google Kubernetes Engine, dan Cloud Storage. Dengan demikian, Anda tidak perlu mengelola sertifikat terpisah untuk aplikasi serverless.

Load balancer tidak mengganggu atau berinteraksi dengan aturan pemilihan rute di file dispatch.yaml Anda. Aturan dispatch.yaml tidak dievaluasi hingga NEG serverless mengarahkan traffic ke App Engine.

Perhatikan hal-hal berikut:

  • Sebaiknya gunakan kontrol traffic masuk sehingga aplikasi Anda hanya menerima permintaan yang dikirim dari load balancer (dan VPC jika Anda menggunakannya). Jika tidak, pengguna dapat menggunakan URL App Engine aplikasi Anda untuk mengabaikan load balancer, kebijakan keamanan Google Cloud Armor, sertifikat SSL, dan kunci pribadi yang diteruskan melalui load balancer.

Detail tambahan tentang URL App Engine

Memahami ID Region di URL

REGION_ID adalah kode singkat yang Google tetapkan berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode provinsi dan negara yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal ini, ID region bersifat opsional dalam URL.

Anda dapat menggunakan alat berikut untuk melihat ID region aplikasi Anda:

Konsol

Di konsol Google Cloud, Anda dapat melihat URL untuk Instances, Services, dan Versions aplikasi Anda.

Semua URL ini menyertakan ID region.

gcloud

Saat Anda men-deploy aplikasi atau layanan, perintah gcloud app deploy akan menampilkan URL setelah deployment berhasil. URL ini menyertakan ID region.

Untuk melihat URL layanan yang telah di-deploy:

  1. Masukkan perintah gcloud app versions list untuk mencantumkan versi layanan tertentu. Misalnya, untuk mencantumkan versi layanan default, masukkan gcloud app versions list --service=default.

  2. Masukkan perintah gcloud app versions describe. Output perintah tersebut mencakup URL versi dengan ID region aplikasi. Misalnya, untuk menjelaskan versi 20191023t101741 untuk layanan default, masukkan gcloud app versions describe 20191023t101741 --service=default

Nama domain disertakan dalam data permintaan

Nama domain yang digunakan untuk permintaan disertakan dalam data permintaan yang diteruskan ke aplikasi Anda. Oleh karena itu, Anda dapat menggunakan data permintaan untuk mengontrol cara aplikasi merespons berdasarkan nama domain dalam permintaan. Misalnya, jika ingin mengalihkan ke domain resmi, Anda dapat membuat kode aplikasi untuk memeriksa header permintaan Host, lalu merespons sesuai dengan nama domain tersebut.