Halaman ini menunjukkan cara membuat Load Balancer Aplikasi eksternal untuk mengarahkan permintaan ke backend serverless. Di sini, istilah serverless mengacu pada produk komputasi serverless berikut:
- App Engine
- Cloud Functions
- Cloud Run
Integrasi Load Balancer Aplikasi eksternal dengan Gateway API memungkinkan backend serverless memanfaatkan semua fitur yang disediakan oleh Cloud Load Balancing. Untuk mengonfigurasi Load Balancer Aplikasi eksternal guna mengarahkan traffic ke Gateway API, baca artikel Memulai Load Balancer Aplikasi eksternal untuk Gateway API. Dukungan Load Balancer Aplikasi Eksternal untuk Gateway API berada di Pratinjau.
NEG Serverless memungkinkan Anda menggunakan aplikasi serverless Google Cloud dengan Load Balancer Aplikasi eksternal. Setelah Anda mengonfigurasi load balancer dengan backend NEG serverless, permintaan ke load balancer akan dirutekan ke backend aplikasi serverless.
Untuk mempelajari NEG serverless lebih lanjut, baca Ringkasan NEG Tanpa Server.
Sebelum memulai
- Deploy layanan App Engine, Cloud Functions, atau Cloud Run.
- Instal Google Cloud CLI jika Anda belum melakukannya.
- Mengonfigurasi izin.
- Tambahkan resource sertifikat SSL.
Men-deploy layanan App Engine, Cloud Functions, atau Cloud Run
Petunjuk di halaman ini mengasumsikan bahwa Anda sudah menjalankan layanan Cloud Run, Cloud Functions, atau App Engine.
Untuk contoh di halaman ini, kami telah menggunakan panduan memulai Cloud Run Python untuk men-deploy layanan Cloud Run di region us-central1
. Bagian selanjutnya dari halaman ini akan menunjukkan cara menyiapkan Load Balancer Aplikasi eksternal yang menggunakan backend NEG serverless untuk mengarahkan permintaan ke layanan ini.
Jika Anda belum men-deploy aplikasi serverless, atau jika ingin mencoba NEG serverless dengan aplikasi contoh, gunakan salah satu panduan memulai berikut. Anda dapat membuat aplikasi serverless di region mana pun, tetapi Anda harus menggunakan region yang sama nanti untuk membuat NEG serverless dan load balancer.
Cloud Run
Untuk membuat aplikasi Halo Dunia sederhana, kemas ke dalam image container, lalu deploy image container ke Cloud Run. Lihat Panduan Memulai: Mem-build dan Men-deploy.
Jika Anda sudah mengupload container contoh ke Container Registry, lihat Panduan Memulai: Men-deploy Container Contoh Bawaan.
Cloud Functions
Lihat Panduan Memulai Cloud Functions: Python.
App Engine
Lihat panduan memulai App Engine berikut untuk Python 3:
Menginstal Google Cloud CLI.
Instal Google Cloud CLI. Lihat Ringkasan gcloud untuk mengetahui informasi konseptual dan penginstalan tentang alat ini.
Jika Anda belum menjalankan gcloud CLI sebelumnya, jalankan gcloud init
terlebih dahulu untuk melakukan inisialisasi direktori gcloud Anda.
Konfigurasikan izin
Untuk mengikuti panduan ini, Anda perlu membuat NEG serverless dan membuat load balancer HTTP(S) eksternal di sebuah project. Anda harus menjadi pemilik atau editor project, atau Anda harus memiliki peran IAM Compute Engine berikut:
Tugas | Peran yang Diperlukan |
---|---|
Membuat komponen jaringan dan load balancer | Admin Jaringan |
Membuat dan mengubah NEG | Compute Instance Admin |
Membuat dan mengubah sertifikat SSL | Security Admin |
Mencadangkan alamat IP eksternal
Setelah layanan Anda aktif dan berjalan, siapkan alamat IP eksternal statis global yang digunakan pelanggan untuk menjangkau load balancer Anda.
Konsol
Di konsol Google Cloud, buka halaman External IP addresses.
Klik Reserve external static IP address.
Untuk Name, masukkan
example-ip
.Untuk Tingkat layanan jaringan, pilih Premium.
Untuk IP version, pilih IPv4.
Untuk Jenis, pilih Global.
Klik Reserve.
gcloud
gcloud compute addresses create example-ip \ --network-tier=PREMIUM \ --ip-version=IPV4 \ --global
Perhatikan alamat IPv4 yang dicadangkan:
gcloud compute addresses describe example-ip \ --format="get(address)" \ --global
Membuat resource sertifikat SSL
Untuk membuat load balancer HTTPS, Anda harus menambahkan resource sertifikat SSL ke front end load balancer. Buat resource sertifikat SSL menggunakan sertifikat SSL yang dikelola Google atau sertifikat SSL yang dikelola sendiri.
Sertifikat yang dikelola Google. Sebaiknya gunakan sertifikat yang dikelola Google karena Google Cloud mendapatkan, mengelola, dan memperpanjang sertifikat ini secara otomatis. Untuk membuat sertifikat yang dikelola Google, Anda harus memiliki domain dan data DNS untuk domain tersebut agar sertifikat dapat disediakan. Jika belum memiliki domain, Anda bisa mendapatkannya dari Google Domains. Untuk mengetahui informasi selengkapnya, lihat Memulai Google Domains. Selain itu, Anda perlu memperbarui data A DNS domain agar mengarah ke alamat IP load balancer yang dibuat di langkah sebelumnya (
example-ip
). Untuk petunjuk mendetail, lihat Menggunakan sertifikat yang dikelola Google.Sertifikat yang ditandatangani sendiri. Jika saat ini Anda tidak ingin menyiapkan domain, Anda dapat menggunakan sertifikat SSL yang ditandatangani sendiri untuk melakukan pengujian.
Contoh ini mengasumsikan bahwa Anda telah membuat resource sertifikat SSL.
Jika ingin menguji proses ini tanpa membuat resource sertifikat SSL (atau domain seperti yang diwajibkan oleh sertifikat yang dikelola Google), Anda tetap dapat menggunakan petunjuk di halaman ini untuk menyiapkan load balancer HTTP.
Membuat load balancer
Dalam diagram berikut, load balancer menggunakan backend NEG serverless untuk mengarahkan permintaan ke layanan Cloud Run serverless. Untuk contoh ini, kami telah menggunakan panduan memulai Cloud Run Python untuk men-deploy layanan Cloud Run.
Karena health check tidak didukung untuk layanan backend dengan backend NEG serverless, Anda tidak perlu membuat aturan firewall yang mengizinkan health check jika load balancer hanya memiliki backend NEG serverless.
Konsol
Memulai konfigurasi Anda
Di Konsol Google Cloud, buka halaman Load balancing.
- Klik Create load balancer.
- Untuk Type of load balancer, pilih Application Load Balancer (HTTP/HTTPS) lalu klik Next.
- Untuk Public facing or internal, pilih Public facing (eksternal), lalu klik Next.
- Untuk Global or single region deployment, pilih Best for global Workload, lalu klik Next.
- Untuk Load balancer generasi, pilih classic Application Load Balancer dan klik Next.
- Klik Konfigurasikan.
Konfigurasi dasar
- Untuk nama load balancer, masukkan
serverless-lb
. - Biarkan jendela tetap terbuka untuk melanjutkan.
Konfigurasi frontend
- Klik Frontend configuration.
- Untuk Name, masukkan nama.
-
Untuk membuat load balancer HTTPS, Anda harus memiliki sertifikat SSL (
gcloud compute ssl-certificates list
).Sebaiknya gunakan sertifikat yang dikelola Google seperti yang dijelaskan sebelumnya.
- Klik Done.
Untuk mengonfigurasi Load Balancer Aplikasi eksternal, isi kolom sebagai berikut.
Pastikan opsi berikut dikonfigurasi dengan nilai ini:
Properti | Nilai (ketik nilai atau pilih opsi yang ditentukan) |
---|---|
Protokol | HTTPS |
Network Service Tier | Premium |
IP version | IPv4 |
Alamat IP | example-ip |
Port | 443 |
Certificate | Pilih sertifikat SSL yang ada atau buat sertifikat baru. Untuk membuat load balancer HTTPS, Anda harus memiliki resource sertifikat SSL untuk digunakan di proxy HTTPS. Anda dapat membuat resource sertifikat SSL menggunakan sertifikat SSL yang dikelola Google atau sertifikat SSL yang dikelola sendiri. Untuk membuat sertifikat yang dikelola Google, Anda harus memiliki domain. Data A domain harus di-resolve ke alamat IP load balancer (dalam contoh ini, example-ip). Direkomendasikan untuk menggunakan sertifikat yang dikelola Google karena Google Cloud akan mendapatkan, mengelola, dan memperpanjang sertifikat ini secara otomatis. Jika tidak memiliki domain, Anda dapat menggunakan sertifikat SSL yang ditandatangani sendiri untuk pengujian. |
Opsional: Mengaktifkan Pengalihan HTTP ke HTTPS |
Gunakan kotak centang ini untuk mengaktifkan pengalihan HTTP ke HTTPS.
Jika kotak ini dicentang, load balancer HTTP sebagian tambahan akan menggunakan alamat IP yang sama dengan load balancer HTTPS dan akan mengalihkan permintaan HTTP ke frontend HTTPS load balancer. Kotak centang ini hanya dapat dipilih jika protokol HTTPS dipilih dan alamat IP yang dicadangkan digunakan. |
Konfigurasi backend
- Klik Backend configuration.
- Dalam daftar Backend services & backend buckets, klik Create a backend service.
- Untuk Name, masukkan nama.
- Di Backend type, pilih Serverless network endpoint group.
- Jangan ubah Protocol. Parameter ini diabaikan.
- Di bagian Backends, untuk New backend, pilih Create Serverless network endpoint group.
- Untuk Name, masukkan nama.
- Klik Create.
- Di bagian New backend, klik Done.
- Pilih Aktifkan Cloud CDN.
- Opsional: Ubah setelan mode cache dan TTL.
- Klik Create.
Aturan perutean
Aturan pemilihan rute menentukan cara traffic Anda diarahkan. Untuk mengonfigurasi perutean, Anda akan menyiapkan aturan host dan pencocok jalur, yang merupakan komponen konfigurasi dari peta URL Load Balancer Aplikasi eksternal.
-
Klik Host and path rules.
- Pertahankan host dan jalur default. Untuk contoh ini, semua permintaan mengarah ke layanan backend yang dibuat di langkah sebelumnya.
Meninjau konfigurasi
- Klik Review and finalize.
- Tinjau semua setelan.
- Opsional: Klik Equivalent Code untuk melihat permintaan REST API yang akan digunakan untuk membuat load balancer.
- Klik Create.
- Tunggu load balancer dibuat.
- Klik nama load balancer (serverless-lb).
- Catat alamat IP load balancer untuk tugas berikutnya. Nama ini
disebut sebagai
IP_ADDRESS
.
gcloud
- Buat NEG serverless untuk aplikasi serverless Anda.
Untuk mengetahui opsi lainnya, lihat panduan referensi
gcloud
untukgcloud compute network-endpoint-groups create
. - Buat layanan backend.
gcloud compute backend-services create BACKEND_SERVICE_NAME \ --load-balancing-scheme=LOAD_BALANCING_SCHEME \ --global \ --enable-cdn \ --cache-mode=CACHE_MODE \ --custom-response-header='Cache-Status: {cdn_cache_status}' \ --custom-response-header='Cache-ID: {cdn_cache_id}'
Tetapkan mode cache dengan mengganti CACHE_MODE dengan salah satu hal berikut:
CACHE_All_STATIC
(default): Otomatis meng-cache konten statis.USE_ORIGIN_HEADERS
: Mewajibkan origin menetapkan header caching yang valid untuk menyimpan konten dalam cache.FORCE_CACHE_ALL
: Menyimpan semua konten dalam cache, dengan mengabaikan perintahprivate
,no-store
, atauno-cache
di header responsCache-Control
.
Untuk informasi tentang perintah cache yang dipahami Cloud CDN dan apa yang tidak di-cache oleh Cloud CDN, lihat Konten yang dapat disimpan dalam cache dan Konten yang tidak dapat disimpan dalam cache.
- Tambahkan NEG serverless sebagai backend ke layanan backend:
gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \ --global \ --network-endpoint-group=SERVERLESS_NEG_NAME \ --network-endpoint-group-region=us-central1
- Buat peta URL untuk mengarahkan permintaan masuk ke layanan backend:
gcloud compute url-maps create URL_MAP_NAME \ --default-service BACKEND_SERVICE_NAME
Contoh peta URL ini hanya menargetkan satu layanan backend yang mewakili satu aplikasi serverless, sehingga kita tidak perlu menyiapkan aturan host atau pencocok jalur. Jika memiliki lebih dari satu layanan backend, Anda dapat menggunakan aturan host untuk mengarahkan permintaan ke layanan yang berbeda berdasarkan nama host, dan Anda juga dapat menyiapkan pencocok jalur untuk mengarahkan permintaan ke berbagai layanan berdasarkan jalur permintaan.
-
Untuk membuat load balancer HTTPS, Anda harus memiliki
resource sertifikat
SSL untuk digunakan di proxy target HTTPS.
Anda dapat membuat resource sertifikat SSL menggunakan sertifikat SSL yang dikelola Google atau sertifikat SSL yang dikelola sendiri. Sebaiknya gunakan sertifikat yang dikelola Google
karena Google Cloud mendapatkan, mengelola, dan memperpanjang
sertifikat ini secara otomatis.
Untuk membuat sertifikat yang dikelola Google, Anda harus memiliki domain. Jika tidak memiliki domain, Anda dapat menggunakan sertifikat SSL yang ditandatangani sendiri untuk pengujian.
Untuk membuat resource sertifikat SSL yang dikelola Google:gcloud compute ssl-certificates create SSL_CERTIFICATE_NAME \ --domains DOMAIN
Untuk membuat resource sertifikat SSL yang dikelola sendiri:gcloud compute ssl-certificates create SSL_CERTIFICATE_NAME \ --certificate CRT_FILE_PATH \ --private-key KEY_FILE_PATH
-
Buat proxy HTTP(S) target untuk merutekan permintaan ke peta URL Anda.
Untuk load balancer HTTPS, buat proxy target HTTPS. Proxy adalah bagian dari load balancer yang menyimpan sertifikat SSL untuk Load Balancing HTTPS, sehingga Anda juga memuat sertifikat pada langkah ini.
gcloud compute target-https-proxies create TARGET_HTTPS_PROXY_NAME \ --ssl-certificates=SSL_CERTIFICATE_NAME \ --url-map=URL_MAP_NAME
- Buat aturan penerusan untuk mengarahkan permintaan masuk ke proxy.
Untuk load balancer HTTPS:
gcloud compute forwarding-rules create HTTPS_FORWARDING_RULE_NAME \ --load-balancing-scheme=EXTERNAL \ --network-tier=PREMIUM \ --address=example-ip \ --target-https-proxy=TARGET_HTTPS_PROXY_NAME \ --global \ --ports=443
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
Setelah mengonfigurasi load balancer, Anda dapat mulai mengirim traffic ke alamat IP load balancer. Jika mengonfigurasi domain, Anda juga dapat mengirim traffic ke nama domain. Namun, penerapan DNS dapat memerlukan waktu untuk menyelesaikan pengujian sehingga Anda dapat memulai dengan menggunakan alamat IP untuk pengujian.
Di Konsol Google Cloud, buka halaman Load balancing.
Klik load balancer yang baru saja dibuat.
Catat alamat IP load balancer internal.
Untuk load balancer HTTPS, Anda dapat menguji load balancer menggunakan browser web dengan membuka
https://IP_ADDRESS
. GantiIP_ADDRESS
dengan alamat IP load balancer. Anda akan diarahkan ke halaman beranda layananhelloworld
.
Jika tidak berhasil dan Anda menggunakan sertifikat yang dikelola Google, konfirmasi bahwa status resource sertifikat Anda AKTIF. Untuk mengetahui informasi selengkapnya, lihat Status resource sertifikat SSL yang dikelola Google.
Jika Anda menggunakan sertifikat yang ditandatangani sendiri untuk pengujian, browser akan menampilkan peringatan. Anda harus secara eksplisit memerintahkan browser untuk menerima sertifikat yang ditandatangani sendiri. Klik peringatan untuk melihat halaman sebenarnya.Untuk memverifikasi respons cache, gunakan curl dari command line komputer Anda. Ganti IP_ADDRESS dengan alamat IPv4 load balancer.
curl -v -o/dev/null https://IP_ADDRESS
Jika Anda menggunakan sertifikat yang dikelola Google, uji domain yang mengarah ke alamat IP load balancer. Contoh:
curl -v -o/dev/null -k -s 'https://DOMAIN:443' --connect-to DOMAIN:443:IP_ADDRESS:443
Jika menggunakan sertifikat yang ditandatangani sendiri, Anda juga harus menentukan flag
-k
. Opsi curl-k
memungkinkan curl berfungsi jika Anda memiliki sertifikat yang ditandatangani sendiri. Anda hanya boleh menggunakan parameter-k
untuk menguji situs Anda sendiri. Dalam keadaan normal, sertifikat yang valid adalah tindakan keamanan yang penting dan peringatan sertifikat tidak boleh diabaikan.Output harus berisi header kustom
Cache-ID
danCache-Status
yang telah Anda konfigurasi untuk menunjukkan apakah respons disalurkan dari cache:HTTP/2 200 cache-status: hit cache-id: SEA-b9fa975e
Output-nya berisi header respons yang menunjukkan adanya cache yang ditemukan, yang berarti aset statis dalam aplikasi serverless disajikan kepada pengguna dari edge cache Cloud CDN.
Header
cache-status
menyatakan nilaidisabled
untuk respons yang tidak disimpan dalam cache di Cloud CDN. Untuk respons yang di-cache, nilai headercache-status
adalahhit
,miss
, ataurevalidated
.
Menonaktifkan Cloud CDN
Konsol
Menonaktifkan Cloud CDN untuk layanan backend tunggal
Di konsol Google Cloud, buka halaman Cloud CDN.
Di sisi kanan baris origin, klik Menu
lalu pilih Edit.Kosongkan kotak centang untuk layanan backend yang ingin Anda hentikan penggunaan Cloud CDN.
Klik Perbarui.
Menghapus Cloud CDN untuk semua layanan backend untuk asal
Di konsol Google Cloud, buka halaman Cloud CDN.
Di sisi kanan baris asal, klik Menu
lalu pilih Remove.Untuk mengonfirmasi, klik Hapus.
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 Cloud CDN lalu mengaktifkannya kembali, sebagian besar atau semua konten yang disimpan dalam cache mungkin masih disimpan dalam cache. Agar konten tidak digunakan oleh cache, Anda harus membatalkan validasi konten tersebut.
Langkah selanjutnya
- Lihat dokumentasi Cloud CDN untuk mempelajari mode cache lebih lanjut dan menentukan kemampuan cache respons Anda.