All Products
Search
Document Center

Alibaba Cloud Service Mesh:Kelola filter Envoy dengan templat

Last Updated:Mar 11, 2026

Saat memperbarui atau memelihara instans Service Mesh (ASM), filter Envoy yang dikelola sendiri berisiko rusak akibat ketidakcocokan versi. Templat filter Envoy mengatasi masalah ini dengan secara otomatis menyesuaikan filter ke setiap versi ASM—Anda cukup mendefinisikan satu templat, mengikatnya ke workload atau namespace, dan ASM akan membuat serta memelihara filter Envoy terkait selama peningkatan.

ApproachVersion compatibilityReusabilityMaintenance
Envoy filter templateOtomatis — filter menyesuaikan saat instans ASM diperbaruiSatu templat dapat digunakan untuk beberapa workloadUbah templat sekali; semua filter diperbarui
Standalone Envoy filterManual — perlu memeriksa dan memperbaiki setelah setiap pembaruanSetiap filter dikonfigurasi secara independenPerbarui setiap filter satu per satu

Perilaku utama:

  • Templat berfungsi sebagai cetak biru; filter Envoy merupakan instans dari templat tersebut. Templat menentukan cara traffic diproses tetapi tidak langsung diterapkan pada traffic.

  • Satu templat dapat menghasilkan beberapa filter Envoy di berbagai workload dan namespace.

  • Memodifikasi templat secara otomatis memperbarui semua filter Envoy yang dibuat darinya.

  • Menghapus templat secara otomatis menghapus semua filter Envoy yang dihasilkannya.

  • Melepas ikatan templat dari suatu workload atau namespace secara otomatis menghapus filter Envoy untuk cakupan tersebut.

  • Mengikat templat ke namespace istio-system menjadikannya berlaku secara global dan secara otomatis melepas ikatannya dari semua workload dan namespace lainnya.

Prasyarat

Buat templat Envoy filter

  1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

  2. Di halaman Mesh Management, klik nama instans ASM Anda. Di panel navigasi kiri, pilih Plugin Extension Center > EnvoyFilter Template.

  3. Klik Create EnvoyFilter Template.

  4. Di bagian Basic Information, masukkan nama untuk templat.

  5. Di bagian Multi-version adapted EnvoyFilter templates, klik Add an EnvoyFilter template for specific adapted istio version.

  6. Pilih versi Istio dari daftar drop-down Adapted istio version, konfigurasikan parameter filter, lalu klik Create.

    Catatan
    • Untuk instans ASM versi 1.18.0.146 atau lebih baru, opsi No Minimum Version Limit dan No Maximum Version Limit dipilih secara default. Untuk membatasi rentang versi, kosongkan salah satu opsi tersebut dan masukkan versi spesifik.

    • Untuk detail tentang bidang konfigurasi EnvoyFilter dan contohnya, lihat Envoy Filter.

Templat muncul di halaman EnvoyFilter Template.

Ikat templat ke workload atau namespace

Setelah membuat templat, ikatkan ke satu atau beberapa workload atau namespace. ASM kemudian secara otomatis membuat filter Envoy yang sesuai.

Ikat ke workload

  1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

  2. Di halaman Mesh Management, klik nama instans ASM Anda. Di panel navigasi kiri, pilih Plugin Extension Center > EnvoyFilter Template.

  3. Temukan templat dan klik Edit template di kolom Actions.

  4. Buka konfigurasi pengikatan:

    • Versi sebelum 1.18.0.146: Klik tab Bind template to workloads, lalu klik Bind EnvoyFilter to Workloads.

    • Versi 1.18.0.146 atau lebih baru: Gulir ke bagian Bind template to workloads. Jika muncul pesan "The EnvoyFilter template has adapted this version, but the correspond EnvoyFilters has not been created", klik Create terlebih dahulu. Lalu klik Bind EnvoyFilter to Workloads.

  5. Di kotak dialog Bind EnvoyFilter to Workloads, atur parameter Namespace dan Workload Type, klik Bind di samping workload target di bagian Not bound, lalu klik OK.

Untuk memverifikasi, buka Plugin Extension Center > EnvoyFilter di panel navigasi kiri. Filter Envoy yang dibuat secara otomatis muncul di halaman EnvoyFilter.

Ikat ke namespace

  1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

  2. Di halaman Mesh Management, klik nama instans ASM Anda. Di panel navigasi kiri, pilih Plugin Extension Center > EnvoyFilter Template.

  3. Temukan templat dan klik Edit template di kolom Actions.

  4. Buka konfigurasi pengikatan:

    • Versi sebelum 1.18.0.146: Klik tab Bind template to workloads, lalu klik Bind EnvoyFilter to Namespace.

    • Versi 1.18.0.146 atau lebih baru: Gulir ke bagian Bind template to workloads. Jika muncul pesan "The EnvoyFilter template has adapted this version, but the correspond EnvoyFilters has not been created", klik Create terlebih dahulu. Lalu klik Bind EnvoyFilter to Namespace.

  5. Di kotak dialog Bind EnvoyFilter to Namespace, klik namespace target di bagian Not bound dan klik OK.

    Catatan

    Mengikat templat ke namespace istio-system menjadikannya berlaku secara global. Templat secara otomatis dilepas dari semua workload dan namespace lainnya.

Untuk memverifikasi, buka Plugin Extension Center > EnvoyFilter di panel navigasi kiri. Filter Envoy yang dibuat secara otomatis muncul di halaman EnvoyFilter.

Modifikasi templat

Catatan

Hanya templat kustom yang dapat dimodifikasi. Templat bawaan, yang diberi label ASM plug-in di halaman EnvoyFilter Template, tidak dapat dimodifikasi.

  1. Masuk ke Konsol ASM. Di panel navigasi kiri, pilih Service Mesh > Mesh Management.

  2. Di halaman Mesh Management, klik nama instans ASM Anda. Di panel navigasi kiri, pilih Plugin Extension Center > EnvoyFilter Template.

  3. Temukan templat dan klik Edit template di kolom Actions.

  4. Perbarui parameter templat dan klik Modify template contents.

Semua filter Envoy yang dibuat dari templat ini secara otomatis diperbarui.

Lepaskan ikatan atau hapus templat dan filter

Hapus filter Envoy dengan melepas ikatan templatnya dari cakupan target, atau hapus templat itu sendiri untuk menghapus semua filter terkait.

Lepaskan ikatan templat dari workload

Di halaman EnvoyFilter Template, klik Edit template untuk templat target. Di tab Bind template to workloads, klik Bind EnvoyFilter to Workloads. Di kotak dialog, klik Unbind di samping workload di bagian Bound dan klik OK. Filter Envoy untuk workload tersebut secara otomatis dihapus.

Lepaskan ikatan templat dari namespace

Di halaman EnvoyFilter Template, klik Edit template untuk templat target. Di tab Bind template to workloads, klik Bind EnvoyFilter to Namespace. Di kotak dialog, klik namespace di bagian Bound dan klik OK. Filter Envoy untuk namespace tersebut secara otomatis dihapus.

Hapus templat

Di halaman EnvoyFilter Template, temukan templat dan klik Delete di kolom Actions. Klik OK untuk mengonfirmasi. Semua filter Envoy yang dibuat dari templat ini secara otomatis dihapus.