Tüm Ürünler
Search

Bu Ürün

    Alibaba Cloud Service Mesh:EnvoyFilterTemplate and EnvoyFilterTemplateBinding field reference

    Belge Merkezi

    Alibaba Cloud Service Mesh:EnvoyFilterTemplate and EnvoyFilterTemplateBinding field reference

    Son Güncelleme:Oct 07, 2026

    Service Mesh (ASM), yeniden kullanılabilir ve sürüm farkındalığına sahip Envoy filtre yapılandırmaları oluşturmak için iki Özel Kaynak Tanımı (CRD) sunar: EnvoyFilterTemplate ve EnvoyFilterTemplateBinding. Bir filtre şablonunu bir kez tanımlayın, ardından YAML dosyalarını çoğaltmadan bunu iş yüklerine, ad alanlarına ve Istio sürümlerine bağlayın.

    Neden ham EnvoyFilter kaynakları yerine bu CRD'leri kullanmalısınız?

    • Sürüm güvenliği. Manuel olarak yönetilen EnvoyFilter kaynakları, Envoy proxy sürümü değiştiği için bir ASM örneği yükseltmesinden sonra uyumsuz hale gelebilir. EnvoyFilterTemplate, sürüme özel filtre yapılandırmaları tanımlamanıza olanak tanır; böylece yükseltmeden sonra doğru filtre otomatik olarak uygulanır.

    • Yeniden kullanılabilirlik. Tek bir şablon, ayrı bağlamalar aracılığıyla iş yükleri ve ad alanları arasında birden çok EnvoyFilter kaynağı üretir.

    • Daha az çoğaltma. Meta veriler ve iş yükü seçiciler bağlamadan otomatik olarak doldurulur. Bunları şablonda çoğaltmanız gerekmez.

    Önemli

    Tek bir EnvoyFilterTemplate içinde tanımlanan istioVersion aralıkları örtüşmemelidir.

    Nasıl çalışır

    1. Her biri belirli bir Istio sürüm aralığını hedefleyen bir veya daha fazla filtre yapılandırması içeren bir EnvoyFilterTemplate oluşturun.

    2. Şablonu referans alan ve filtrenin hangi iş yüklerine ve Envoy proxy sürümlerine uygulanacağını belirten bir EnvoyFilterTemplateBinding oluşturun.

    3. ASM, doğru meta veriler, etiketler ve iş yükü seçicileri ile ilgili EnvoyFilter kaynaklarını otomatik olarak oluşturur.

    Yapılandırma örneği

    Aşağıdaki örnek, Istio 1,19 ve sonraki sürümleri çalıştıran ASM örnekleri için 80 numaralı bağlantı noktasında HTTP/2 bağlantı ve akış pencere boyutlarını ayarlayan bir EnvoyFilterTemplate tanımlar. İlgili bir EnvoyFilterTemplateBinding daha sonra, istio-system ad alanında genel olarak uygulanan ve 1,20 sürümündeki proxy'leri hedefleyen bir Envoy filtresi oluşturur.

    EnvoyFilterTemplate

    EnvoyFilterTemplateBinding

    apiVersion: istio.alibabacloud.com/v1
kind: EnvoyFilterTemplateBinding
metadata:
  name: seth2windows-binding-1.20
  namespace: istio-system
spec:
  templateRef:
    istioVersion: "1.20"
    name: seth2windows
  workloads:
  - kind: Namespace
    namespace: istio-system

    Oluşturulan EnvoyFilter

    ASM, yukarıdaki şablon ve bağlamadan aşağıdaki EnvoyFilter'ı üretir. Etiketler ve proxyVersion eşleşme koşulu bağlamadan otomatik olarak doldurulur:

    EnvoyFilterTemplate alanları

    EnvoyFilterTemplate, farklı Istio sürümleri için Envoy filtre yapılandırmalarını tanımlar. Bir ASM örneği yükseltildikten sonra, eşleşen filtre yapılandırması yükseltilen Envoy proxy'lerine otomatik olarak uygulanır; bu da manuel olarak yönetilen EnvoyFilter kaynaklarına kıyasla uyumluluk risklerini azaltır.

    EnvoyFilterTemplateSpec


    Alan


    Tür


    Gerekli


    Açıklama


    templates


    TemplateValue[]


    Evet


    Envoy filtre şablonu girişlerinin listesi. Her giriş belirli bir Istio sürümünü veya sürüm aralığını hedefler. Girişler arasındaki sürüm aralıkları örtüşmemelidir.

    TemplateValue

    Her TemplateValue, bir Envoy filtre yapılandırmasını (YAML formatında) uygulandığı Istio sürüm aralığıyla eşleştirir.

    Alan

    Tür

    Gerekli

    Açıklama

    istioVersion

    string

    Evet

    Bu filtrenin hedeflediği Istio sürümü veya sürüm aralığı. 1,19 veya 1,20 gibi bir Istio küçük sürümü belirtin. Bir aralık tanımlamak için iki sürümü tire ile ayırın. En eski bilinen sürüm için MIN_VERSION ve en yeni sürüm için MAX_VERSION kullanın. Bkz. Sürüm aralığı sözdizimi.

    value

    string

    Evet

    YAML formatındaki Envoy filtre yapılandırması. EnvoyFilter CRD spesifikasyonuna uygun olmalıdır. metadata ve workloadSelector alanlarını atlayın; ASM bunları oluşturma sırasında EnvoyFilterTemplateBinding'den otomatik olarak doldurur.

    Sürüm aralığı sözdizimi


    Örnek


    Anlamı


    "1.19"


    Yalnızca Istio 1,19 çalıştıran ASM örnekleriyle eşleşir.


    "1.18-1.20"


    Istio 1,18, 1,19 ve 1,20 ile eşleşir.


    "1.19-MAX_VERSION"


    Istio 1,19 ve tüm sonraki sürümlerle eşleşir.


    "MIN_VERSION-1.19"


    Istio 1,19 ve tüm önceki sürümlerle eşleşir.

    EnvoyFilterTemplateBinding alanları

    Bir EnvoyFilterTemplateBinding, bir EnvoyFilterTemplate ile ilişkilendirilir ve ASM'nin EnvoyFilter kaynaklarını oluşturacağı iş yüklerini ve Envoy proxy sürümlerini belirtir.

    EnvoyFilterTemplateBindingSpec


    Alan


    Tür


    Gerekli


    Açıklama


    templateRef


    EnvoyFilterTemplateRef


    Evet


    EnvoyFilterTemplate'i referans alır ve hedeflenecek Envoy proxy sürümünü belirtir. ASM bunu doğru şablon girişini seçmek ve oluşturulan EnvoyFilter'da proxyVersion eşleşmesini ayarlamak için kullanır.


    workloads


    WorkloadRef[]


    Hayır


    Envoy filtrelerinin oluşturulacağı iş yükleri.

    EnvoyFilterTemplateRef


    Alan


    Tür


    Gerekli


    Açıklama


    name


    string


    Evet


    Referans alınacak EnvoyFilterTemplate'in adı.


    istioVersion


    string


    Evet


    Hedeflenecek Envoy proxy sürümü. TemplateValue.istioVersion ile aynı Sürüm aralığı sözdizimini kullanır. ASM bu değeri, oluşturulan EnvoyFilter'da bir proxyVersion regex eşleşmesine dönüştürür (örneğin, "1.20" değeri ^1\.20.* haline gelir).

    WorkloadRef

    Oluşturulan Envoy filtresinin uygulanacağı iş yüklerini tanımlar.


    Alan


    Tür


    Gerekli


    Varsayılan davranış


    Açıklama


    namespace


    string


    Evet


    --


    Envoy filtresinin oluşturulduğu ad alanı. Filtreyi ASM örneği genelinde uygulamak için bunu istio-system olarak ayarlayın.


    name


    string


    Hayır


    Filtre ad alanı genelinde uygulanır.


    İş yükü adı. Bu değer, oluşturulan EnvoyFilter adına dahil edilir. Belirli bir iş yükünü hedeflediğinizde bunu Service veya Deployment adına ayarlayın.


    kind


    string


    Hayır


    --


    İş yükü türü (örneğin, Namespace, Deployment veya Service). Yalnızca görüntüleme amaçlıdır ve filtre davranışını etkilemez.


    selector


    map<string, string>


    Hayır


    Filtre ad alanındaki tüm pod'lara uygulanır.


    Belirli pod'ları seçmek için bir etiket kümesi. ASM bunu, oluşturulan EnvoyFilter'ın workloadSelector alanına dönüştürür. Atlanırsa, filtre belirtilen ad alanındaki tüm pod'lara uygulanır.

    Başvurular