Service Mesh (ASM) menyediakan antarmuka pengguna grafis (GUI) yang intuitif untuk gerbang. Anda dapat membuat Destination Rule dan Virtual Service langsung di konsol tanpa menulis File YAML, sehingga menyederhanakan manajemen traffic. Topik ini menjelaskan cara membuat kebijakan traffic dan aturan routing melalui GUI.
Prasyarat
-
Sidecar telah diinjeksikan ke dalam namespace. Untuk informasi selengkapnya, lihat Aktifkan injeksi otomatis.
Gerbang masuk (Ingress Gateway) telah dideploy. Untuk informasi selengkapnya, lihat Buat gerbang masuk.
Aplikasi telah dideploy di kluster yang ditambahkan ke instans ASM. Untuk informasi selengkapnya, lihat Deploy aplikasi ke kluster yang terasosiasi dengan ASM.
-
Alamat gerbang ASM tersedia. Untuk informasi selengkapnya, lihat Mendapatkan alamat gerbang masuk.
Contoh
Topik ini menggunakan layanan Reviews sebagai contoh untuk menunjukkan cara mengonfigurasi kebijakan traffic, seperti load balancing dan kolam koneksi, melalui GUI. Setelah kebijakan traffic dibuat, File YAML Destination Rule akan dibuat secara otomatis. Topik ini juga menggunakan aplikasi Bookinfo sebagai contoh untuk menunjukkan cara membuat aturan routing untuk path seperti /productpage dan /login di GUI, sehingga Anda dapat mengakses aplikasi Bookinfo melalui path tersebut, misalnya /productpage.
Buat domain
-
Masuk ke Konsol ASM. Di panel navigasi sebelah kiri, pilih .
-
Di halaman Mesh Management, klik nama instans ASM. Di panel navigasi sebelah kiri, pilih .
-
Di halaman Ingress Gateway, klik nama gerbang target. Di panel navigasi sebelah kiri halaman detail gerbang, klik Domain/Certificate.
-
Di halaman Add domain, konfigurasikan parameter berikut lalu klik Create.
Parameter
Contoh
Domain
*
Protocol
HTTP
Namespaces
default
Port Name
http
Port
80
Impor layanan hulu
Impor layanan ke gerbang ASM untuk mengasosiasikan gerbang dengan layanan tersebut.
-
Di halaman Ingress Gateway, klik nama gerbang target. Di panel navigasi sebelah kiri halaman detail gerbang, klik Upstream Service.
-
Di halaman Upstream Service, klik Import service. Di halaman Import service, pilih Namespaces, pilih layanan reviews dan productpage, klik ikon
, lalu klik Confirm.
Buat kebijakan traffic
-
Kelola versi layanan.
Pada contoh ini, layanan Reviews dibagi menjadi v1, v2, dan v3.
-
Di halaman Upstream Service, klik versions pada kolom Operator untuk layanan reviews.
-
Di halaman versions, klik Add Service Version (Subset), masukkan v1 untuk Name, klik Add Label, atur Key menjadi version, dan atur Value menjadi v1.
-
Klik Add Service Version (Subset), masukkan v2 untuk Name, klik Add Label, atur Key menjadi version, dan atur Value menjadi v2.
-
Klik Add Service Version (Subset) lagi, masukkan v3 untuk Name, klik Add Label, atur Key menjadi version, atur Value menjadi v3, lalu klik Create.
-
-
Buat kebijakan traffic.
-
Di halaman Upstream Service, klik traffic policy pada kolom Operator untuk layanan reviews.
-
Di halaman traffic policy, klik Add Policy, pilih Subset Level, pilih versi v3, aktifkan sakelar Load Balancing, pilih Simple, atur Mode menjadi Random, lalu klik Submit.
-
-
(Opsional) Lihat File YAML untuk Destination Rule yang dihasilkan dari kebijakan traffic.
Di halaman Upstream Service, klik View YAML pada kolom Operator untuk layanan reviews. Di kotak dialog Preview, lihat File YAML tersebut. Setelah memastikan file sudah benar, klik Confirm.
CatatanAnda juga dapat memilih di panel navigasi sebelah kiri halaman detail mesh. Di halaman DestinationRule, klik View YAML pada kolom Operator untuk Destination Rule tersebut. Di kotak dialog Edit, lihat File YAML Destination Rule yang dihasilkan.
Buat aturan routing
-
Buat aturan routing.
-
Buat rute
/productpage.-
Di panel navigasi sebelah kiri halaman detail gerbang, klik Route management lalu klik Create.
-
Di halaman wizard set route detail, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
route type
Pilih http.
Namespaces
Pilih default.
route name
Masukkan
productpage-route.description
Masukkan
productpage route.priority
Masukkan
3.CatatanAturan routing memiliki prioritas. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Jika URI cocok dengan beberapa aturan routing, aturan dengan prioritas tertinggi yang akan diterapkan.
Matching rules
Atur pencocokan URL untuk hanya mengarahkan permintaan yang memenuhi persyaratan tertentu ke layanan tujuan.
Aktifkan sakelar Matching request URI, atur Method menjadi Exact, dan atur Content menjadi
/productpage.CatatanAnda juga dapat mengklik Add Header Matching Rule untuk mengatur pencocokan header.
-
Di halaman wizard set route destination, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
select upstream service
Pilih layanan tempat aturan routing diterapkan. Pada contoh ini, pilih productpage.
Port
Parameter ini opsional. Tentukan port yang diekspos oleh layanan hulu. Jika layanan hulu mengekspos beberapa port, Anda harus menentukan salah satunya. Pada contoh ini, biarkan bidang ini kosong.
Subset
Tentukan versi layanan (subset) tempat aturan routing diterapkan. Pada contoh ini, biarkan bidang ini kosong.
Weight
Tentukan bobot traffic untuk tujuan ini. Pada contoh ini, biarkan bidang ini kosong.
-
Di halaman wizard advanced config, aktifkan sakelar Fault Injection, aktifkan sakelar Request Latency, atur Latency menjadi 4s, atur Injection Percentage menjadi 100, lalu klik Create.
-
-
Buat rute
/static.-
Di halaman Route management, klik Create.
-
Di halaman wizard set route detail, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
route type
Pilih http.
Namespaces
Pilih default.
route name
Masukkan
static.description
Masukkan
static resources.priority
Masukkan
0.Matching rules
Atur pencocokan URL untuk hanya mengarahkan permintaan yang memenuhi persyaratan tertentu ke layanan tujuan.
Aktifkan sakelar Matching request URI, atur Method menjadi Prefix, dan atur Content menjadi
/static. -
Langkah-langkah selanjutnya untuk membuat rute
/staticsama dengan langkah-langkah untuk membuat rute/productpage. Untuk informasi selengkapnya, lihat Buat rute /productpage.
-
-
Buat rute
/login.-
Di halaman Route management, klik Create.
-
Di halaman wizard set route detail, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
route type
Pilih http.
Namespaces
Pilih default.
route name
Masukkan
login.description
Masukkan
login request route.priority
Masukkan
0.Matching rules
Atur pencocokan URL untuk hanya mengarahkan permintaan yang memenuhi persyaratan tertentu ke layanan tujuan.
Aktifkan sakelar Matching request URI, atur Method menjadi Prefix, dan atur Content menjadi
/login. -
Langkah-langkah selanjutnya untuk membuat rute
/loginsama dengan langkah-langkah untuk membuat rute/productpage. Untuk informasi selengkapnya, lihat Buat rute /productpage.
-
-
Buat rute
/logout.-
Di halaman Route management, klik Create.
-
Di halaman wizard set route detail, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
route type
Pilih http.
Namespaces
Pilih default.
route name
Masukkan
logout.description
Masukkan
logout route.priority
Masukkan
0.Matching rules
Atur pencocokan URL untuk hanya mengarahkan permintaan yang memenuhi persyaratan tertentu ke layanan tujuan.
Aktifkan sakelar Matching request URI, atur Method menjadi Prefix, dan atur Content menjadi /logout.
-
Langkah-langkah selanjutnya untuk membuat rute /logout sama dengan langkah-langkah untuk membuat rute /productpage. Untuk informasi selengkapnya, lihat Buat rute /productpage.
-
-
Buat rute
/api/v1/products.-
Di halaman Route management, klik Create.
-
Di halaman wizard set route detail, konfigurasikan parameter berikut lalu klik Next.
Parameter
Contoh
route type
Pilih http.
Namespaces
Pilih default.
route name
Masukkan
products-route.description
Masukkan
product information.priority
Masukkan
0.Matching rules
Atur pencocokan URL untuk hanya mengarahkan permintaan yang memenuhi persyaratan tertentu ke layanan tujuan.
Aktifkan sakelar Matching request URI, atur Method menjadi Prefix, dan atur Content menjadi
/api/v1/products. -
Langkah-langkah selanjutnya untuk membuat rute
/api/v1/productssama dengan langkah-langkah untuk membuat rute/productpage. Untuk informasi selengkapnya, lihat Buat rute /productpage.
-
-
-
Verifikasi aturan routing.
-
Di bilah alamat browser Anda, masukkan
http://{alamat IP gerbang masuk}/productpage.Halaman detail produk dari aplikasi contoh Bookinfo ditampilkan. Judul halaman adalah The Comedy of Errors. Di kolom kiri, Book Details menampilkan informasi seperti jenis buku, jumlah halaman, penerbit, bahasa, dan ISBN. Di kolom kanan, Book Reviews menampilkan komentar pengguna dan peringkat bintang. Hal ini menunjukkan bahwa aplikasi layanan mikro telah dideploy dan dapat diakses.
-
Di pojok kanan atas halaman Bookinfo, klik Sign in.
-
Di halaman Please sign in, masukkan username dan password apa pun, lalu klik Sign in.
Anda berhasil masuk ke aplikasi Bookinfo. Halaman detail produk ditampilkan, dan username default muncul di pojok kanan atas bilah navigasi.
Anda juga dapat menggunakan /logout, /static, dan /api/v1/products untuk mengakses layanan Bookinfo guna verifikasi.
-
Buka alat developer browser Anda dan beralih ke tab Network.
-
Segarkan halaman.
Anda akan mengamati penundaan sekitar 4 detik. Di panel Network alat developer browser Anda, permintaan untuk halaman
productpagemembutuhkan waktu sekitar 4,21 detik, sedangkan sumber daya statis lainnya dimuat dalam hitungan milidetik. Hal ini menunjukkan bahwa aturan routing telah berlaku dan pemuatan halaman mengalami penundaan signifikan.
-
-
(Opsional) Lihat File YAML untuk Virtual Service yang dihasilkan dari aturan routing.
-
Di halaman detail instans ASM, pilih di panel navigasi sebelah kiri.
-
Di halaman Virtual Service, klik View YAML pada kolom Operator untuk virtual service target.
-
Di kotak dialog Edit, lihat File YAML Virtual Service yang dihasilkan. Setelah memastikan file sudah benar, klik OK.
-
Operasi terkait
Lihat detail layanan
Lihat informasi tentang layanan yang diimpor, seperti apakah sidecar telah diinjeksikan dan wilayah layanan.
-
Di halaman Ingress Gateway, klik nama gerbang target. Di panel navigasi sebelah kiri halaman detail gerbang, klik Upstream Service.
-
Di halaman Upstream Service, klik service details pada kolom Operator untuk layanan target. Di halaman service details, lihat informasi seperti apakah sidecar telah diinjeksikan dan wilayah layanan.
Nonaktifkan rute
Nonaktifkan aturan routing untuk menonaktifkannya.
-
Di halaman Ingress Gateway, klik nama gerbang target.
-
Di panel navigasi sebelah kiri halaman detail gerbang, klik Route management.
-
Di halaman Route management, klik offline pada kolom Operator untuk rute target.
-
Di kotak dialog Confirm, klik OK.
-
Verifikasi bahwa rute telah dinonaktifkan.
-
Di bilah alamat browser Anda, masukkan
http://{alamat IP gerbang masuk}/productpage. -
Di pojok kanan atas halaman Bookinfo, klik Sign in.
-
Di halaman Please sign in, masukkan username dan password apa pun, lalu klik Sign in.
Muncul error "Page Not Found", yang mengonfirmasi bahwa aturan routing tidak aktif dan rute telah dinonaktifkan.
CatatanAnda juga dapat mengaktifkan kembali rute tersebut:
Di halaman Route management, klik online pada kolom Operator untuk rute target. Di kotak dialog Confirm, klik OK.
-