Menyiapkan VM Compute Engine menggunakan deployment Envoy otomatis

Dokumen ini berlaku untuk API lama. Jika Anda men-deploy dengan API perutean layanan baru, yang masih dalam pratinjau, lihat Penyiapan Cloud Service Mesh untuk proxy Envoy dengan layanan HTTP.

Sebelum mengikuti petunjuk dalam panduan ini, selesaikan tugas prasyarat yang dijelaskan di Bersiap untuk menyiapkan di API perutean layanan dengan workload Envoy dan tanpa proxy.

Panduan ini menunjukkan cara men-deploy data plane yang terdiri dari proxy sidecar Envoy secara otomatis, mengonfigurasinya menggunakan Cloud Service Mesh, dan memverifikasi penyiapan Anda untuk memastikan penyiapan tersebut berfungsi dengan benar. Proses ini mencakup hal berikut:

  1. Mengaktifkan Cloud OS Config API.
  2. Membuat layanan pengujian.
  3. Men-deploy data plane sederhana di Compute Engine menggunakan proxy Envoy (Envoy versi 1.18.4, yang hanya mendukung xDS v3).
  4. Menyiapkan Cloud Service Mesh menggunakan Compute Engine API, yang memungkinkan Cloud Service Mesh mengonfigurasi proxy sidecar Envoy Anda.
  5. Login ke VM yang menjalankan proxy Envoy dan mengirim permintaan ke backend yang di-load balance melalui proxy Envoy.

Contoh konfigurasi dalam dokumen ini hanya untuk tujuan demonstrasi. Untuk lingkungan produksi, Anda mungkin perlu men-deploy komponen tambahan, berdasarkan lingkungan dan persyaratan Anda.

Mengaktifkan Cloud OS Config API

Pastikan Anda mengaktifkan Cloud OS Config API. Jika tidak melakukannya, Anda tidak dapat menginstal komponen yang diperlukan di VM.

Untuk melakukannya:

Konsol

  1. Di Google Cloud konsol, buka API & layanan.
    Buka halaman Library API
  2. Pilih project yang benar.
  3. Di kotak penelusuran, masukkan Cloud OS Config API , lalu tekan Enter.
  4. Pilih Cloud OS Config API.
  5. Klik Enable.

gcloud 

gcloud services enable osconfig.googleapis.com

Membuat layanan pengujian Hello World

Bagian ini menunjukkan cara membuat layanan pengujian sederhana yang menampilkan nama host VM yang melayani permintaan dari klien. Layanan pengujian ini tidak rumit; layanan ini adalah server web yang di-deploy di seluruh grup instance terkelola Compute Engine.

Membuat template instance untuk layanan pengujian Hello World

Template instance yang Anda buat mengonfigurasi contoh server web apache2 menggunakan parameter startup-script.

Konsol

  1. Di Google Cloud konsol, buka halaman Instance Templates.

    Buka Instance Templates

  2. Klik Create instance template.
  3. Di kolom, masukkan informasi berikut:
    • Name: td-demo-hello-world-template
    • Boot disk: Pilih sistem operasi dan versi.
    • Service account: Compute Engine default service account
    • Access scopes: Allow full access to all Cloud APIs
  4. Klik Management, Security, Disks, Networking, Sole Tenancy. 1 Di tab Networking, di kolom Network tags, tambahkan tag td-http-server.

  5. Di tab Management, salin skrip berikut ke kolom Startup script.

    #!/bin/bash
sudo apt-get update -y
sudo apt-get install apache2 -y
sudo service apache2 restart
echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html

  6. Klik Create.

gcloud

Anda dapat memilih di antara banyak versi sistem operasi. Contoh ini menggunakan nilai default Debian 10.

Untuk membuat template instance:

gcloud compute instance-templates create td-demo-hello-world-template \
  --machine-type=n1-standard-1 \
  --boot-disk-size=20GB \
  --image-family=debian-10  \
  --image-project=debian-cloud \
  --scopes=https://www.googleapis.com/auth/cloud-platform \
  --tags=td-http-server \
  --metadata=startup-script="#! /bin/bash
sudo apt-get update -y
sudo apt-get install apache2 -y
sudo service apache2 restart
sudo mkdir -p /var/www/html/
echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html"

Membuat grup instance terkelola untuk layanan Hello World

Di bagian ini, Anda menentukan bahwa grup instance terkelola selalu memiliki dua instance layanan pengujian. Hal ini hanya untuk tujuan demonstrasi. Cloud Service Mesh mendukung grup instance terkelola yang di-autoscaling.

Konsol

  1. Di Google Cloud konsol, buka halaman Instance Groups.

    Buka halaman Instance Groups

  2. Klik Create instance group.
  3. Pilih New managed instance group (stateless). Untuk mengetahui informasi selengkapnya, lihat MIG stateless atau stateful.
  4. Masukkan td-demo-hello-world-mig sebagai nama untuk grup instance terkelola, lalu pilih zona us-central1-a.
  5. Di bagian Instance template, pilih td-demo-hello-world-template, yang merupakan template instance yang Anda buat.
  6. Di bagian Autoscaling mode, pilih Off:do not autoscale.
  7. Di bagian Maximum number of instances, tentukan setidaknya dua sebagai jumlah instance yang ingin Anda buat dalam grup.
  8. Klik Create.

gcloud

Gunakan gcloud CLI untuk membuat grup instance terkelola dengan template instance yang Anda buat sebelumnya.

gcloud compute instance-groups managed create td-demo-hello-world-mig \
  --zone us-central1-a \
  --size=2 \
  --template=td-demo-hello-world-template

Membuat template instance dan grup instance terkelola tempat Envoy di-deploy

Gunakan petunjuk di bagian ini untuk membuat template instance dan grup instance terkelola untuk Cloud Service Mesh dengan proxy Envoy yang di-deploy secara otomatis. Grup instance terkelola membuat VM backend baru menggunakan autoscaling.

Komponen software yang berjalan di VM Anda

Komponen berikut diinstal di VM Anda saat Anda membuat template instance dengan --service-proxy=enabled.

  • Proxy Envoy, yang dikonfigurasi oleh Cloud Service Mesh, didownload dari bucket Cloud Storage khusus. Bucket ini berisi build proxy Envoy yang disediakan Google.
  • Agen proxy layanan, yang menginisialisasi proxy Envoy dan komponen proxy. Agen proxy layanan menyiapkan pencegatan traffic dan memantau kondisi proxy Envoy saat VM berjalan. Agen proxy layanan juga didownload dari bucket Cloud Storage.

Satu-satunya versi Envoy yang tersedia adalah biner Envoy terbaru yang dihosting di lokasi Cloud Storage khusus. Versi Envoy ini didukung di Compute Engine Debian, CentOS 7/8, dan RHEL 7/8. Selama autohealing dan penskalaan, grup instance terkelola menginstal Envoy versi terbaru di VM. Dalam beberapa kasus, versi ini mungkin lebih baru daripada Envoy yang di-deploy ke instance VM yang dibuat sebelumnya. Hal ini dapat menyebabkan ketidakkonsistenan dalam versi yang diinstal di seluruh VM dalam grup instance terkelola. Versi yang tidak konsisten berfungsi bersama dengan benar. Jika ada update keamanan untuk Envoy, sebaiknya upgrade grup instance terkelola menggunakan penggantian bertahap.

Membuat template instance

Template instance menentukan konfigurasi instance VM yang dibuat dalam grup instance terkelola. Flag yang Anda teruskan ke template instance menginstal Envoy dan mengonfigurasi instance VM Anda agar siap untuk Cloud Service Mesh.

Anda dapat menggunakan Debian 10/11, CentOS 7/8, atau RHEL 7/8 untuk image disk boot di template instance.

Untuk membuat template instance tersebut:

  gcloud compute instance-templates create td-vm-template-auto \
    --image-family=[ debian-10 | centos-7 | centos-8 | rhel-7 | rhel-8 ]  \
    --image-project=[ debian-cloud | centos-cloud |rhel-cloud ] \
    --service-proxy=enabled

Untuk menyesuaikan deployment Envoy, lihat Panduan referensi deployment Envoy otomatis.

Membuat grup instance terkelola

Konsol

  1. Di Google Cloud konsol, buka halaman Instance Groups.

    Buka Instance Groups

  2. Klik Create an instance group.
  3. Masukkan td-vm-mig-us-central1 sebagai nama untuk grup instance terkelola, lalu pilih zona us-central1-a.
  4. Di bagian Group type, pilih Managed instance group.
  5. Di bagian Instance template, pilih td-vm-template-auto, template instance yang Anda buat.
  6. Tentukan 2 sebagai jumlah instance yang ingin Anda buat dalam grup.
  7. Klik Create untuk membuat grup baru.

gcloud

Gunakan gcloud CLI untuk membuat grup instance terkelola dengan template instance yang Anda buat sebelumnya.

 gcloud compute instance-groups managed create td-vm-mig-us-central1 \
    --zone us-central1-a --size=2 --template=td-vm-template-auto

Mengonfigurasi Cloud Service Mesh dengan Google Cloud komponenload balancing

Petunjuk di bagian ini menunjukkan cara mengonfigurasi Cloud Service Mesh sehingga proxy Envoy Anda melakukan load balancing traffic keluar di dua instance backend. Anda mengonfigurasi komponen berikut:

Membuat health check

Gunakan petunjuk berikut untuk membuat health check. Untuk mengetahui informasi selengkapnya, lihat Membuat health check.

Konsol

  1. Buka halaman Health checks di Google Cloud konsol.
    Buka halaman Health checks
  2. Klik Create Health Check.
  3. Untuk nama, masukkan td-vm-health-check.
  4. Untuk protokol, pilih HTTP.
  5. Klik Create.

gcloud

  1. Buat health check.

    gcloud compute health-checks create http td-vm-health-check

Membuat aturan firewall

Gunakan petunjuk berikut untuk membuat aturan firewall yang diperlukan untuk pemeriksaan health check. Untuk mengetahui informasi selengkapnya, lihat Aturan firewall untuk health check.

Konsol

  1. Buka halaman Firewall policies di Google Cloud konsol.
    Buka halaman Firewall policies
  2. Klik Create firewall rule.
  3. Di halaman Create a firewall rule, berikan informasi berikut:
    • Name: fw-allow-health-checks
    • Network: Pilih jaringan VPC.
    • Prioritas: Masukkan angka untuk prioritas atau 1000 secara default.
    • Direction of traffic: Pilih ingress.
    • Action on match: Pilih allow.
    • Targets: Pilih Specified target tags, lalu masukkan td-http-server di kotak teks Target tags.
    • Filter sumber: Pilih jenis rentang IP yang benar.
    • Source IP ranges: 35.191.0.0/16,130.211.0.0/22
    • Destination filter: Pilih jenis IP.
    • Protocols and ports: Klik Specified ports and protocols, lalu centang jenis tcp di port 80

gcloud

  1. Buat aturan firewall untuk health check.

    gcloud compute firewall-rules create fw-allow-health-checks \
  --action ALLOW \
  --direction INGRESS \
  --source-ranges 35.191.0.0/16,130.211.0.0/22 \
  --target-tags td-http-server \
  --rules tcp:80

Membuat layanan backend

Buat layanan backend. Jika menggunakan Google Cloud CLI, Anda harus menetapkannya sebagai layanan backend global dengan skema load balancing INTERNAL_SELF_MANAGED. Tambahkan health check dan grup instance terkelola atau tidak terkelola ke layanan backend. Perhatikan bahwa contoh ini menggunakan grup instance terkelola dengan template VM Compute Engine yang menjalankan layanan HTTP contoh yang dibuat di bagian Membuat grup instance terkelola.

Konsol

  1. Buka halaman Cloud Service Mesh di Google Cloud konsol.

    Buka halaman Cloud Service Mesh

  2. Di tab Services, klik Create Service.

  3. Klik Continue.

  4. Untuk nama layanan, masukkan td-vm-service.

  5. Pilih jaringan VPC yang benar.

  6. Pastikan Backend type adalah Instance groups.

  7. Pilih td-demo-hello-world-mig, yang merupakan grup instance terkelola yang Anda buat dan berisi backend untuk layanan pengujian Hello World.

  8. Masukkan Port numbers yang benar.

  9. Pilih Utilization atau Rate sebagai Balancing mode. Nilai defaultnya adalah Rate.

  10. Klik Done.

  11. Pilih health check yang Anda buat, atau klik Create another health check dan pastikan untuk memilih HTTP sebagai protokol.

  12. Di Connection draining timeout, tetapkan nilai ke 30 detik atau lebih lama.

  13. Klik Continue.

  14. Klik Create.

gcloud

  1. Buat layanan backend.

    gcloud compute backend-services create td-vm-service \
 --global \
 --load-balancing-scheme=INTERNAL_SELF_MANAGED \
 --connection-draining-timeout=30s \
 --health-checks td-vm-health-check

  2. Tambahkan backend ke layanan backend.

    gcloud compute backend-services add-backend td-vm-service \
  --instance-group td-demo-hello-world-mig \
  --instance-group-zone us-central1-a \
  --global

Membuat peta aturan perutean

Peta aturan perutean menentukan cara Cloud Service Mesh merutekan traffic di mesh Anda. Sebagai bagian dari peta aturan perutean, Anda mengonfigurasi alamat IP virtual (VIP) dan sekumpulan aturan pengelolaan traffic terkait, seperti perutean berbasis host. Saat aplikasi mengirim permintaan ke VIP, proxy Envoy:

  1. Mencegat permintaan.
  2. Mengevaluasinya sesuai dengan aturan pengelolaan traffic di peta URL.
  3. Memilih layanan backend berdasarkan nama host dalam permintaan.
  4. Memilih backend atau endpoint yang terkait dengan layanan backend yang dipilih.
  5. Mengirim traffic ke backend atau endpoint tersebut.

Untuk mengetahui informasi selengkapnya tentang pengelolaan traffic, lihat Pengelolaan traffic lanjutan.

Konsol

Di Google Cloud konsol, pembuatan proxy target digabungkan dengan pembuatan aturan penerusan. Saat Anda membuat aturan penerusan, Google Cloud akan otomatis membuat proxy HTTP target dan melampirkannya ke peta URL.

  1. Buka halaman Cloud Service Mesh di Google Cloud konsol.

    Buka halaman Cloud Service Mesh

  2. Di tab Routing rule maps, klik Create Routing Rule Map.

  3. Masukkan nama.

  4. Klik Add Forwarding Rule.

  5. Untuk nama aturan penerusan, masukkan td-vm-forwarding-rule.

  6. Pilih jaringan Anda.

  7. Pilih Internal IP Anda. Traffic yang dikirim ke alamat IP ini dicegat oleh proxy Envoy dan dikirim ke layanan yang sesuai menurut aturan host dan jalur.

    Aturan penerusan dibuat sebagai aturan penerusan global dengan load-balancing-scheme yang ditetapkan ke INTERNAL_SELF_MANAGED.

  8. Di kolom Custom IP, ketik 10.0.0.1. Saat VM Anda mengirim ke alamat IP ini, proxy Envoy akan mencegatnya dan mengirimkannya ke endpoint layanan backend yang sesuai menurut aturan pengelolaan traffic yang ditentukan dalam peta URL.

    Setiap aturan penerusan dalam jaringan VPC harus memiliki alamat IP dan port yang unik per jaringan VPC. Jika Anda membuat lebih dari satu aturan penerusan dengan alamat IP dan port yang sama dalam jaringan VPC tertentu, hanya aturan penerusan pertama yang valid. Aturan lainnya akan diabaikan. Jika 10.0.0.1 tidak tersedia di jaringan Anda, pilih alamat IP lain.

  9. Pastikan Port ditetapkan ke 80.

  10. Klik Save.

  11. Di bagian Routing rules, pilih Simple host and path rule.

  12. Di bagian Host and path rules, pilih td-vm-service sebagai Layanan.

  13. Klik Add host and path rule.

  14. Di Hosts, masukkan hello-world.

  15. Di Service, pilih td-vm-service.

  16. Klik Save.

gcloud

  1. Buat peta URL yang menggunakan layanan backend td-vm-service sebagai default.

    gcloud compute url-maps create td-vm-url-map \
   --default-service td-vm-service

  2. Buat pencocok jalur dan aturan host untuk merutekan traffic untuk layanan Anda berdasarkan nama host dan jalur. Contoh ini menggunakan td-vm-service sebagai nama layanan dan pencocok jalur default yang cocok dengan semua permintaan jalur untuk host ini (/*).

    gcloud compute url-maps add-path-matcher td-vm-url-map \
   --default-service td-vm-service \
   --path-matcher-name td-vm-path-matcher

    gcloud compute url-maps add-host-rule td-vm-url-map \
   --path-matcher-name=td-vm-path-matcher \
   --hosts=hello-world

  3. Buat proxy HTTP target.

    gcloud compute target-http-proxies create td-vm-proxy \
   --url-map=td-vm-url-map

  4. Buat aturan penerusan.

    Aturan penerusan harus bersifat global dan harus dibuat dengan nilai load-balancing-scheme yang ditetapkan ke INTERNAL_SELF_MANAGED.

    gcloud compute forwarding-rules create td-vm-forwarding-rule \
   --global \
   --load-balancing-scheme=INTERNAL_SELF_MANAGED \
   --address=10.0.0.1 \
   --target-http-proxy=td-vm-proxy \
   --ports=80 \
   --network=default

Pada tahap ini, Cloud Service Mesh dikonfigurasi untuk melakukan load balancing traffic untuk layanan yang ditentukan dalam peta URL di seluruh backend dalam grup instance terkelola.

Memverifikasi konfigurasi

Di bagian terakhir panduan penyiapan Cloud Service Mesh untuk VM Compute Engine ini, Anda akan menguji bahwa traffic yang dikirim dari VM klien yang ditujukan ke VIP aturan penerusan dicegat dan dialihkan ke proxy Envoy, yang kemudian merutekan permintaan Anda ke VM yang menghosting layanan Hello World.

Untuk melakukannya, Anda login ke VM klien, yang telah dikonfigurasi untuk mencegat traffic dan mengalihkannya ke Envoy. Anda mengirim permintaan curl ke VIP yang terkait dengan peta aturan perutean Anda. Envoy memeriksa permintaan curl, menentukan layanan mana yang harus diselesaikan, dan mengirim permintaan ke backend yang terkait dengan layanan tersebut.

  1. Di Google Cloud konsol, buka halaman Instance Groups.

    Buka halaman Instance Groups

  2. Pilih grup instance td-vm-mig-us-central1.
  3. Di bagian ringkasan VM, di bagian Connect, klik SSH.
  4. Setelah login ke VM klien, gunakan alat curl untuk mengirim permintaan ke layanan Hello World melalui Envoy:
curl -H "Host: hello-world" http://10.0.0.1/

Saat Anda mengeluarkan perintah ini berulang kali, Anda akan melihat respons HTML yang berbeda yang berisi nama host backend dalam grup instance terkelola Hello World. Hal ini karena Envoy menggunakan load balancing round robin, algoritma load balancing default, saat mengirim traffic ke backend layanan Hello World.

Langkah berikutnya