Menyiapkan Cloud Run, Cloud Functions, atau App Engine

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.

Buka 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.

Arsitektur Load Balancer Aplikasi Eksternal untuk aplikasi Cloud Run. — Arsitektur Load Balancer Aplikasi Eksternal untuk aplikasi Cloud Run (klik untuk memperbesar).

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.

Buka 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.

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.

Klik Done.

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 untuk gcloud 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 perintah private, no-store, atau no-cache di header respons Cache-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.
Lakukan langkah ini hanya jika Anda ingin membuat load balancer HTTPS. Hal ini tidak diperlukan untuk load balancer HTTP.
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.

Buka 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. 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, 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 dan Cache-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 nilai disabled untuk respons yang tidak disimpan dalam cache di Cloud CDN. Untuk respons yang di-cache, nilai header cache-status adalah hit, miss, atau revalidated.

Menonaktifkan Cloud CDN

Konsol

Menonaktifkan Cloud CDN untuk layanan backend tunggal

Di konsol Google Cloud, buka halaman Cloud CDN.

Buka 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.

Buka 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.