Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan Cloud Run, Cloud Functions, atau App Engine

Halaman ini menunjukkan cara membuat Load Balancer Aplikasi eksternal untuk merutekan permintaan ke backend serverless. Di sini, istilah serverless mengacu pada produk komputasi serverless berikut:

App Engine
Fungsi Cloud Run
Cloud Run

Integrasi Load Balancer Aplikasi eksternal dengan API Gateway memungkinkan backend serverless Anda memanfaatkan semua fitur yang disediakan oleh Cloud Load Balancing. Untuk mengonfigurasi Load Balancer Aplikasi eksternal guna merutekan traffic ke API Gateway, lihat Memulai Load Balancer Aplikasi eksternal untuk API Gateway. Dukungan Load Balancer Aplikasi Eksternal untuk API Gateway masih dalam 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 serverless.

Sebelum memulai

Deploy App Engine, fungsi Cloud Run, atau layanan Cloud Run.
Jika Anda belum melakukannya, instal Google Cloud CLI.
Konfigurasikan izin.
Tambahkan resource sertifikat SSL.

Men-deploy App Engine, fungsi Cloud Run, atau layanan Cloud Run

Petunjuk di halaman ini mengasumsikan bahwa Anda sudah memiliki layanan Cloud Run, Cloud Run Functions, atau App Engine yang berjalan.

Untuk contoh di halaman ini, kami telah menggunakan panduan memulai Cloud Run Python untuk men-deploy layanan Cloud Run di region us-central1. Bagian lain dari halaman ini menunjukkan cara menyiapkan Load Balancer Aplikasi eksternal yang menggunakan backend NEG tanpa server untuk merutekan permintaan ke layanan ini.

Jika Anda belum men-deploy aplikasi serverless, atau jika Anda 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 nantinya untuk membuat NEG dan load balancer serverless.

Cloud Run

Untuk membuat aplikasi Hello World sederhana, kemas ke dalam image container, lalu deploy image container ke Cloud Run, lihat Mulai Cepat: Mem-build dan Men-deploy.

Jika Anda sudah memiliki container contoh yang diupload ke Container Registry, lihat Panduan Memulai: Men-deploy Container Contoh Bawaan.

Cloud Run Functions

Lihat Cloud Run Functions: Panduan Memulai 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.

Konfigurasikan izin

Untuk mengikuti panduan ini, Anda perlu membuat NEG tanpa server dan membuat load balancer HTTP(S) eksternal dalam sebuah project. Anda harus menjadi pemilik atau editor project, atau 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 Alamat IP Eksternal
Klik Reserve external static IP address.
Untuk Name, masukkan example-ip.
Untuk Network service tier, pilih Premium.
Untuk IP version, pilih IPv4.
Untuk Type, 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 memperoleh, 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. Selain itu, Anda perlu memperbarui data A DNS domain agar mengarah ke alamat IP load balancer yang dibuat di langkah sebelumnya (example-ip). Untuk mengetahui petunjuk selengkapnya, lihat Menggunakan sertifikat yang dikelola Google.
Sertifikat yang ditandatangani sendiri. Jika tidak ingin menyiapkan domain saat ini, Anda dapat menggunakan sertifikat SSL yang ditandatangani sendiri untuk 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 masih 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

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 (external), lalu klik Next.
Untuk Global or single region deployment, pilih Best for global workloads, lalu klik Next.
Untuk Load balancer generation, pilih Classic Application Load Balancer, lalu 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
Sertifikat	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`). Sebaiknya gunakan sertifikat yang dikelola Google karena Google Cloud memperoleh, mengelola, dan memperpanjang sertifikat ini secara otomatis. Jika tidak memiliki domain, Anda dapat menggunakan sertifikat SSL yang ditandatangani sendiri untuk pengujian.
Opsional: Aktifkan Pengalihan HTTP ke HTTPS	Gunakan kotak centang ini untuk mengaktifkan pengalihan HTTP ke HTTPS. Mengaktifkan kotak centang ini akan membuat load balancer HTTP parsial tambahan yang menggunakan alamat IP yang sama dengan load balancer HTTPS Anda dan mengalihkan permintaan HTTP ke frontend HTTPS load balancer Anda. 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 bagian Backend type, pilih Serverless network endpoint group.
Jangan ubah Protokol. Parameter ini diabaikan.
Di bagian Backends, untuk New backend, pilih Create Serverless network endpoint group.
Untuk Name, masukkan nama.
Klik Create.
Di bagian Backend baru, klik Selesai.
Pilih Enable Cloud CDN.
Opsional: Ubah setelan mode cache dan TTL.
Klik Create.

Aturan perutean

Aturan perutean menentukan cara traffic Anda diarahkan. Untuk mengonfigurasi pemilihan rute, Anda akan menyiapkan aturan host dan pencocok jalur, yang merupakan komponen konfigurasi dari peta URL Load Balancer Aplikasi eksternal.

Klik Host and path rules.
Mempertahankan host dan jalur default. Untuk contoh ini, semua permintaan akan mengarah ke layanan backend yang dibuat pada 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).
Perhatikan alamat IP load balancer untuk tugas berikutnya. Ini disebut IP_ADDRESS.

gcloud

Buat NEG tanpa server untuk aplikasi serverless Anda. Untuk 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 dari yang berikut ini:
- CACHE_All_STATIC (default): Otomatis meng-cache konten statis.
- USE_ORIGIN_HEADERS: Mewajibkan origin menetapkan header cache yang valid untuk meng-cache konten.
- 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 yang tidak di-cache oleh Cloud CDN, lihat Konten yang dapat di-cache dan Konten yang tidak dapat di-cache.

Tambahkan NEG tanpa server 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 dapat menyiapkan pencocok jalur untuk mengarahkan permintaan ke layanan yang berbeda 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 memperoleh, 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 merupakan 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 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.

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, pastikan status resource sertifikat Anda AKTIF. Untuk 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 lokal 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 -k curl 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 langkah 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 ditayangkan dari cache:
```
HTTP/2 200
cache-status: hit
cache-id: SEA-b9fa975e
```
Output berisi header respons yang menunjukkan bahwa ada hit cache, yang berarti aset statis di aplikasi serverless ditayangkan kepada pengguna dari cache edge Cloud CDN.

Header cache-status menampilkan 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 satu layanan backend

Di konsol Google Cloud, buka halaman Cloud CDN.

Buka Cloud CDN
Di sisi kanan baris asal, klik Menu , lalu pilih Edit.
Hapus centang pada kotak layanan backend yang ingin Anda hentikan penggunaan Cloud CDN-nya.
Klik Perbarui.

Menghapus Cloud CDN untuk semua layanan backend untuk origin

Di konsol Google Cloud, buka halaman Cloud CDN.

Buka Cloud CDN
Di sisi kanan baris asal, klik Menu , lalu pilih Hapus.
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 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

Lihat dokumentasi Cloud CDN untuk mempelajari lebih lanjut mode cache dan menentukan kemampuan cache respons Anda.