Tüm Ürünler
Search
Belge Merkezi

Microservices Engine:Annotations supported by MSE Ingress gateways

Son Güncelleme:Oct 08, 2026

MSE Ingress ağ geçitleri, NGINX Ingress ağ geçitlerinin temel ve yaygın ek açıklamalarını destekleyerek geçiş sürecini kolaylaştırır. Ayrıca gelişmiş trafik yönetimi için 40 ek açıklama daha sunar.

Standart Kubernetes Ingress kaynakları yalnızca Transport Layer Security (TLS) şifrelemesi ve temel Katman-7 HTTP yönlendirmesini yönetir. NGINX Ingress denetleyicileri tek başına, gerçek dünya trafik yönetimi ve güvenlik gereksinimlerini karşılamak için 100'den fazla özel ek açıklama tanımlar. MSE Ingress ağ geçitleri en yaygın NGINX Ingress ek açıklamalarıyla uyumludur; bu sayede mevcut iş yükleri Ingress yapılandırmalarını yeniden yazmadan taşınabilir.

Genel Bakış

Aşağıdaki tabloda ek açıklama kapsamı özetlenmiştir.

NGINX Ingress ek açıklama kapsamı

Kategori Sayı Notlar
Desteklenen 51 Kullanım durumlarının %90'ını kapsar
Yapılandırma gerekmez 15 İşlevsellik açık yapılandırma olmadan kullanılabilir
Planlanan 48 Az sayıda kullanım durumu için geçerlidir
Desteklenmeyen 5 NGINX'e özel kod parçacıklarına bağlıdır
MSE özellikleri NGINX'ten farklı şekilde uygular. NGINX Ingress ek açıklamalarında ve kod parçacıklarında kullanılan NGINX değişkenleri, NGINX muadilleriyle uyumlu değildir.

Büyük istek gövdeleri: NGINX'te nginx.ingress.kubernetes.io/proxy-body-size ek açıklaması maksimum istek gövde boyutunu ayarlar ve bu sınırı aşan istekleri reddeder. MSE bunun yerine chunked transfer encoding kullanır; bu yöntem büyük gövdeleri boyut sınırı olmadan otomatik olarak işler. Upstream bağlantı arabellek sınırlarını ayarlamak için MSE ağ geçidinizin Parameter Settings bölmesindeki DownstreamConnectionBufferLimits parametresini yapılandırın.

Yönlendirmeler ve NGINX değişkenleri: Yönlendirme ek açıklamalarındaki NGINX değişkenleri (örneğin $host veya $request_uri) bazı NGINX Ingress sürümlerinde çalışsa da resmi olarak belgelenmemiştir. NGINX Ingress'te yönlendirmeler için NGINX değişkenlerini kullanmaktan kaçının; bunlar MSE ile uyumlu değildir.

MSE'ye özel ek açıklamalar

Kategori Sayı Notlar
Genişletilmiş ek açıklamalar 40 NGINX Ingress'in ötesinde trafik yönetimi ve güvenlik koruma yetenekleri ekler

Ek açıklama kapsamı

Her ek açıklama üç kapsamdan birinde uygulanır:

  • Ingress — Ingress kaynağında tanımlanan yönlendirme kuralları için geçerlidir.

  • Domain — Ingress kaynağında tanımlanan ana bilgisayar adları için geçerlidir ve diğer Ingress kaynaklarında aynı ana bilgisayar adlarında da etkili olur.

  • Service — Ingress kaynağı tarafından başvurulan arka uç hizmetleri için geçerlidir ve diğer Ingress kaynaklarında aynı hizmetlerde de etkili olur.

Ek açıklama ön ekleri

MSE uyumlu ek açıklamalar nginx veya mse ön ekinin herhangi birini kabul eder. Örneğin, nginx.ingress.kubernetes.io/ssl-redirect ve mse.ingress.kubernetes.io/ssl-redirect eşdeğerdir.

MSE'ye özel ek açıklamalar yalnızca mse ön ekini kullanır. Bu ek açıklamalar için mse yerine nginx kullanmanın hiçbir etkisi yoktur.

Hızlı referans dizini

Aşağıdaki tabloda tüm desteklenen ek açıklamalar, uyumluluk durumları ve kategorileriyle listelenmiştir. Ayrıntıları okumadan önce belirli bir ek açıklamanın desteklenip desteklenmediğini hızlıca kontrol etmek için bu tabloyu kullanın.

Ek Açıklama Durum Kategori
nginx.ingress.kubernetes.io/canary Uyumlu Canary sürümü
nginx.ingress.kubernetes.io/canary-by-header Uyumlu Canary sürümü
nginx.ingress.kubernetes.io/canary-by-header-value Uyumlu Canary sürümü
nginx.ingress.kubernetes.io/canary-by-header-pattern Uyumlu Canary sürümü
mse.ingress.kubernetes.io/canary-by-query MSE'ye özel Canary sürümü
mse.ingress.kubernetes.io/canary-by-query-value MSE'ye özel Canary sürümü
mse.ingress.kubernetes.io/canary-by-query-pattern MSE'ye özel Canary sürümü
nginx.ingress.kubernetes.io/canary-by-cookie Uyumlu Canary sürümü
mse.ingress.kubernetes.io/canary-by-cookie-value MSE'ye özel (V1.2.30+) Canary sürümü
nginx.ingress.kubernetes.io/canary-weight Uyumlu Canary sürümü
nginx.ingress.kubernetes.io/canary-weight-total Uyumlu Canary sürümü
mse.ingress.kubernetes.io/destination MSE'ye özel Çoklu hizmet yönlendirmesi
mse.ingress.kubernetes.io/service-subset MSE'ye özel (V1.2.25+) Hizmet alt kümesi
mse.ingress.kubernetes.io/subset-labels MSE'ye özel (V1.2.25+) Hizmet alt kümesi
nginx.ingress.kubernetes.io/default-backend Uyumlu Yedekleme hizmeti
nginx.ingress.kubernetes.io/custom-http-errors Uyumlu Yedekleme hizmeti
nginx.ingress.kubernetes.io/use-regex Uyumlu Regex yol eşleştirme
nginx.ingress.kubernetes.io/rewrite-target Uyumlu Yol yeniden yazma
nginx.ingress.kubernetes.io/upstream-vhost Uyumlu Yol yeniden yazma
nginx.ingress.kubernetes.io/ssl-redirect Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/force-ssl-redirect Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/permanent-redirect Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/permanent-redirect-code Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/temporal-redirect Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/app-root Uyumlu Yönlendirme
nginx.ingress.kubernetes.io/enable-cors Uyumlu CORS
nginx.ingress.kubernetes.io/cors-allow-origin Uyumlu CORS
nginx.ingress.kubernetes.io/cors-allow-methods Uyumlu CORS
nginx.ingress.kubernetes.io/cors-allow-headers Uyumlu CORS
nginx.ingress.kubernetes.io/cors-expose-headers Uyumlu CORS
nginx.ingress.kubernetes.io/cors-allow-credentials Uyumlu CORS
nginx.ingress.kubernetes.io/cors-max-age Uyumlu CORS
mse.ingress.kubernetes.io/request-header-control-add MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/request-header-control-update MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/request-header-control-remove MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/response-header-control-add MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/response-header-control-update MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/response-header-control-remove MSE'ye özel Üst bilgi kontrolü
mse.ingress.kubernetes.io/timeout MSE'ye özel Zaman aşımı
nginx.ingress.kubernetes.io/proxy-next-upstream-tries Uyumlu Yeniden deneme
nginx.ingress.kubernetes.io/proxy-next-upstream-timeout Uyumlu Yeniden deneme
nginx.ingress.kubernetes.io/proxy-next-upstream Uyumlu Yeniden deneme
mse.ingress.kubernetes.io/mirror-target-service MSE'ye özel Trafik yansıtma
mse.ingress.kubernetes.io/mirror-percentage MSE'ye özel (V1.2.32+) Trafik yansıtma
nginx.ingress.kubernetes.io/server-alias Kısmen uyumlu (V1.2.30+) Domain takma adı
mse.ingress.kubernetes.io/route-limit-rpm MSE'ye özel Hız sınırlama (tek ağ geçidi, kullanımdan kaldırılacak)
mse.ingress.kubernetes.io/route-limit-rps MSE'ye özel Hız sınırlama (tek ağ geçidi, kullanımdan kaldırılacak)
mse.ingress.kubernetes.io/route-limit-burst-multiplier MSE'ye özel Hız sınırlama (tek ağ geçidi, kullanımdan kaldırılacak)
mse.ingress.kubernetes.io/rate-limit MSE'ye özel (V1.2.25+) Hız sınırlama (genel)
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code MSE'ye özel (V1.2.25+) Hız sınırlama (genel)
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body-type MSE'ye özel (V1.2.25+) Hız sınırlama (genel)
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body MSE'ye özel (V1.2.25+) Hız sınırlama (genel)
mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url MSE'ye özel (V1.2.25+) Hız sınırlama (genel)
mse.ingress.kubernetes.io/concurrency-limit MSE'ye özel (V1.2.25+) Eşzamanlılık kontrolü
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code MSE'ye özel (V1.2.25+) Eşzamanlılık kontrolü
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body-type MSE'ye özel (V1.2.25+) Eşzamanlılık kontrolü
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body MSE'ye özel (V1.2.25+) Eşzamanlılık kontrolü
mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url MSE'ye özel (V1.2.25+) Eşzamanlılık kontrolü
nginx.ingress.kubernetes.io/backend-protocol Kısmen uyumlu Arka uç protokolü
nginx.ingress.kubernetes.io/load-balance Kısmen uyumlu Yük dengeleme
nginx.ingress.kubernetes.io/upstream-hash-by Kısmen uyumlu Yük dengeleme
mse.ingress.kubernetes.io/warmup MSE'ye özel Hizmet ısınması
nginx.ingress.kubernetes.io/affinity Uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/affinity-mode Kısmen uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/session-cookie-name Uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/session-cookie-path Uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/session-cookie-max-age Uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/session-cookie-expires Uyumlu Çerez benzeşimi
nginx.ingress.kubernetes.io/whitelist-source-range Uyumlu IP erişim kontrolü
nginx.ingress.kubernetes.io/denylist-source-range Uyumlu (V1.2.31+) IP erişim kontrolü
mse.ingress.kubernetes.io/blacklist-source-range MSE'ye özel IP erişim kontrolü
mse.ingress.kubernetes.io/domain-whitelist-source-range MSE'ye özel IP erişim kontrolü
mse.ingress.kubernetes.io/domain-blacklist-source-range MSE'ye özel IP erişim kontrolü
mse.ingress.kubernetes.io/connection-policy-tcp-max-connection MSE'ye özel Bağlantı havuzu
mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint MSE'ye özel Bağlantı havuzu
mse.ingress.kubernetes.io/connection-policy-http-max-request-per-connection MSE'ye özel Bağlantı havuzu
mse.ingress.kubernetes.io/tls-min-protocol-version MSE'ye özel TLS (istemciden ağ geçidine)
mse.ingress.kubernetes.io/tls-max-protocol-version MSE'ye özel TLS (istemciden ağ geçidine)
nginx.ingress.kubernetes.io/ssl-cipher Uyumlu TLS (istemciden ağ geçidine)
mse.ingress.kubernetes.io/auth-tls-secret Kısmen uyumlu TLS (istemciden ağ geçidine)
nginx.ingress.kubernetes.io/proxy-ssl-secret Uyumlu TLS (ağ geçidinden arka uca)
nginx.ingress.kubernetes.io/proxy-ssl-name Uyumlu TLS (ağ geçidinden arka uca)
nginx.ingress.kubernetes.io/proxy-ssl-server-name Uyumlu TLS (ağ geçidinden arka uca)
nginx.ingress.kubernetes.io/auth-type Kısmen uyumlu Kimlik doğrulama
nginx.ingress.kubernetes.io/auth-secret Uyumlu Kimlik doğrulama
nginx.ingress.kubernetes.io/auth-secret-type Uyumlu Kimlik doğrulama
nginx.ingress.kubernetes.io/auth-realm Uyumlu Kimlik doğrulama

Desteklenen ek açıklamalar

Trafik yönetimi

Canary sürümü

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/canary Ingress Uyumlu Ingress için canary sürümünü etkinleştirir.
nginx.ingress.kubernetes.io/canary-by-header Ingress Uyumlu Trafiği istek üst bilgisi anahtarına göre böler.
nginx.ingress.kubernetes.io/canary-by-header-value Ingress Uyumlu Trafiği istek üst bilgisi değerine göre böler. Tam eşleşmeyi destekler.
nginx.ingress.kubernetes.io/canary-by-header-pattern Ingress Uyumlu Trafiği istek üst bilgisi değerine göre böler. Düzenli ifade eşleştirmeyi destekler.
mse.ingress.kubernetes.io/canary-by-query Ingress MSE'ye özel Trafiği URL sorgu parametresi anahtarına göre böler.
mse.ingress.kubernetes.io/canary-by-query-value Ingress MSE'ye özel Trafiği URL sorgu parametresi değerine göre böler. Tam eşleşmeyi destekler.
mse.ingress.kubernetes.io/canary-by-query-pattern Ingress MSE'ye özel Trafiği URL sorgu parametresi değerine göre böler. Düzenli ifade eşleştirmeyi destekler.
nginx.ingress.kubernetes.io/canary-by-cookie Ingress Uyumlu Trafiği çerez anahtarına göre böler.
mse.ingress.kubernetes.io/canary-by-cookie-value Ingress MSE'ye özel (ağ geçidi V1.2.30 veya üzeri gerekir) Trafiği çerez değerine göre böler. Tam eşleşmeyi destekler.
nginx.ingress.kubernetes.io/canary-weight Ingress Uyumlu Canary hizmeti için trafik ağırlığını ayarlar.
nginx.ingress.kubernetes.io/canary-weight-total Ingress Uyumlu Trafik bölme hesaplamaları için kullanılan toplam ağırlığı ayarlar.

Çoklu hizmet yönlendirmesi

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/destination Ingress MSE'ye özel Trafiği birden çok hizmet arasında ağırlığa göre dağıtır.

Söz dizimi: {weight}% {serviceName}.{serviceNamespace}.svc.cluster.local:{port}

Bu ek açıklamayı yapılandırmak, Ingress üzerindeki tüm yönlendirme kuralları için hedef hizmetleri geçersiz kılar. Söz dizimi geçersizse ek açıklama yoksayılır ve orijinal yönlendirme kuralları yürürlükte kalır.

Örnek:

annotations:
  # Route 60% of traffic to foo and 40% to bar
  mse.ingress.kubernetes.io/destination: |
    60% foo.default.svc.cluster.local:8080
    40% bar.default.svc.cluster.local:9090

Hizmet alt kümesi

Tek bir Kubernetes Service birden fazla dağıtımı yönettiğinde (örneğin, kararlı bir sürüm ve bir canary sürümü) hizmet alt kümelerini kullanın. Bir alt küme istekleri belirli bir pod grubuna yönlendirir.

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/service-subset Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) İstekleri hedef hizmetin bir pod alt kümesine yönlendirir. mse.ingress.kubernetes.io/subset-labels ayarlanmadığında yönlendirme davranışı bu ek açıklamanın değerine bağlıdır: "" veya base olarak ayarlarsanız opensergo.io/canary: "" etiketine sahip podları veya opensergo.io/canary etiket ön eki olmayan podları hedeflersiniz; başka bir değer (örneğin gray) girerseniz opensergo.io/canary-gray: gray etiketine sahip podları hedeflersiniz. mse.ingress.kubernetes.io/subset-labels ayarlandığında istekler yalnızca burada tanımlanan anahtar-değer çiftleriyle eşleşen etiketlere sahip podlara iletilir. Hiçbir pod etiketle eşleşmezse istekler hizmetin tüm podlarına geri döner.
mse.ingress.kubernetes.io/subset-labels Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) İsteğe bağlı. Pod alt kümesini tanımlayan etiketleri belirtmek için mse.ingress.kubernetes.io/service-subset ile birlikte kullanın.

Yedekleme hizmeti

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/default-backend Ingress Uyumlu Bir yedekleme hizmeti belirtir. Ingress kuralında tanımlanan hizmet için kullanılabilir düğüm yoksa istekler bu hizmete iletilir.
nginx.ingress.kubernetes.io/custom-http-errors Ingress Uyumlu nginx.ingress.kubernetes.io/default-backend ile birlikte çalışır. Arka uç belirtilen HTTP durum kodlarından birini döndürdüğünde istek, yolu / olarak yeniden yazılarak yedekleme hizmetine iletilir.

Regex yol eşleştirme

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/use-regex Ingress Uyumlu Ingress kuralında tanımlanan yol için düzenli ifade eşleştirmeyi etkinleştirir. RE2 söz dizimini kullanır.

Yol yeniden yazma

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/rewrite-target Ingress Uyumlu İsteği arka uca iletmeden önce yolunu yeniden yazar. Yakalama gruplarını destekler.
nginx.ingress.kubernetes.io/upstream-vhost Ingress Uyumlu İstekleri arka uca iletirken Host üst bilgisini belirtilen değere yeniden yazar.

Yönlendirme

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/ssl-redirect Ingress Uyumlu HTTP isteklerini HTTPS'ye yönlendirir.
nginx.ingress.kubernetes.io/force-ssl-redirect Ingress Uyumlu HTTP isteklerini zorunlu olarak HTTPS'ye yönlendirir.
nginx.ingress.kubernetes.io/permanent-redirect Ingress Uyumlu İstekleri kalıcı yönlendirme ile belirtilen URL'ye yönlendirir.
nginx.ingress.kubernetes.io/permanent-redirect-code Ingress Uyumlu Kalıcı yönlendirmeler için HTTP durum kodunu ayarlar.
nginx.ingress.kubernetes.io/temporal-redirect Ingress Uyumlu İstekleri geçici yönlendirme ile belirtilen URL'ye yönlendirir.
nginx.ingress.kubernetes.io/app-root Ingress Uyumlu İstekleri / konumundan belirtilen uygulama kök yoluna yönlendirir.

Cross-origin resource sharing (CORS)

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/enable-cors Ingress Uyumlu Cross-origin resource sharing (CORS) özelliğini etkinleştirir.
nginx.ingress.kubernetes.io/cors-allow-origin Ingress Uyumlu CORS istekleri için izin verilen kaynakları ayarlar.
nginx.ingress.kubernetes.io/cors-allow-methods Ingress Uyumlu CORS istekleri için izin verilen HTTP yöntemlerini (GET, POST, PUT gibi) ayarlar.
nginx.ingress.kubernetes.io/cors-allow-headers Ingress Uyumlu CORS istekleri için izin verilen istek üst bilgilerini ayarlar.
nginx.ingress.kubernetes.io/cors-expose-headers Ingress Uyumlu CORS yanıtlarında tarayıcılara açılan yanıt üst bilgilerini ayarlar.
nginx.ingress.kubernetes.io/cors-allow-credentials Ingress Uyumlu CORS isteklerinde kimlik bilgilerinin dahil edilip edilemeyeceğini belirtir.
nginx.ingress.kubernetes.io/cors-max-age Ingress Uyumlu Ön istek sonuçlarının önbellekte tutulacağı süreyi ayarlar.

Üst bilgi kontrolü

Temel rotalardaki ve canary rotalardaki üst bilgi kontrolü ek açıklamaları bağımsızdır ve ayrı olarak doğrulanır. Temel rota trafiği ve canary rota trafiği için gerektiğinde farklı üst bilgi ilkeleri yapılandırın.
Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/request-header-control-add Ingress MSE'ye özel İstekleri arka uca iletmeden önce bir üst bilgi ekler. Üst bilgi zaten varsa yeni değer orijinale eklenir. Tek bir üst bilgi için anahtar-değer çifti kullanın. Birden çok üst bilgi için satır başına bir anahtar-değer çifti içeren YAML literal bloğu (|) kullanın.
mse.ingress.kubernetes.io/request-header-control-update Ingress MSE'ye özel İstekleri arka uca iletmeden önce bir üst bilgiyi değiştirir. Üst bilgi varsa yeni değer orijinalin üzerine yazılır. Söz dizimi request-header-control-add ile aynıdır.
mse.ingress.kubernetes.io/request-header-control-remove Ingress MSE'ye özel İstekleri arka uca iletmeden önce üst bilgileri kaldırır. Tek bir üst bilgi için anahtarı belirtin. Birden çok üst bilgi için anahtarları virgülle ayırın.
mse.ingress.kubernetes.io/response-header-control-add Ingress MSE'ye özel Yanıtları istemciye iletmeden önce bir üst bilgi ekler. Üst bilgi zaten varsa yeni değer orijinale eklenir. Söz dizimi request-header-control-add ile aynıdır.
mse.ingress.kubernetes.io/response-header-control-update Ingress MSE'ye özel Yanıtları istemciye iletmeden önce bir üst bilgiyi değiştirir. Üst bilgi varsa yeni değer orijinalin üzerine yazılır. Söz dizimi request-header-control-add ile aynıdır.
mse.ingress.kubernetes.io/response-header-control-remove Ingress MSE'ye özel Yanıtları istemciye iletmeden önce üst bilgileri kaldırır. Tek bir üst bilgi için anahtarı belirtin. Birden çok üst bilgi için anahtarları virgülle ayırın.

Zaman aşımı

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/timeout Ingress MSE'ye özel İstek zaman aşımını saniye cinsinden ayarlar. Varsayılan olarak zaman aşımı uygulanmaz. TCP taşıma katmanında değil, uygulama katmanında uygulanır.

Yeniden deneme

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/proxy-next-upstream-tries Ingress Uyumlu Maksimum yeniden deneme sayısını ayarlar. Varsayılan: 3.
nginx.ingress.kubernetes.io/proxy-next-upstream-timeout Ingress Uyumlu Yeniden deneme girişimleri için zaman aşımını saniye cinsinden ayarlar. Varsayılan olarak zaman aşımı uygulanmaz.
nginx.ingress.kubernetes.io/proxy-next-upstream Ingress Uyumlu Yeniden denemeyi tetikleyen koşulları ayarlar. Desteklenen değerler için NGINX yeniden deneme mekanizmasına bakın.

Trafik yansıtma

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/mirror-target-service Ingress MSE'ye özel Gelen trafiğin bir kopyasını belirtilen hizmete iletir. Biçim: namespace/name:port. namespace varsayılan olarak Ingress ağ geçidinin ad alanıdır. port varsayılan olarak hizmetin ilk bağlantı noktasıdır.
mse.ingress.kubernetes.io/mirror-percentage Ingress MSE'ye özel (ağ geçidi V1.2.32 veya üzeri gerekir) Yansıtılacak trafik yüzdesini ayarlar. Geçerli değerler: 0–100. Varsayılan: 100.

Domain takma adı

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/server-alias Domain Kısmen uyumlu — yalnızca tam eşleşen domainler ve joker karakterli domainler (ağ geçidi V1.2.30 veya üzeri gerekir) Ingress spec'indeki ana bilgisayar adı için bir domain takma adı tanımlar. Takma ad, kaynak domainin TLS, yönlendirme ve trafik yönetimi yapılandırmasını devralır.

Hız sınırlama (tek ağ geçidi, kullanımdan kaldırılacak)

Kısıtlama tetiklendiğinde yanıt gövdesi local_rate_limited olur. Yanıt durum kodu ağ geçidi sürümüne bağlıdır: V1.2.23'ten önceki ağ geçitleri 503 döndürür; V1.2.23 ve sonraki sürümler 429 döndürür.

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/route-limit-rpm Ingress MSE'ye özel Bir rotadaki maksimum dakika başına istek sayısını (RPM) ayarlar. Burst limiti, bu değerin mse.ingress.kubernetes.io/route-limit-burst-multiplier ile çarpımına eşittir.
mse.ingress.kubernetes.io/route-limit-rps Ingress MSE'ye özel Bir rotadaki maksimum saniye başına istek sayısını (RPS) ayarlar. Burst limiti, bu değerin mse.ingress.kubernetes.io/route-limit-burst-multiplier ile çarpımına eşittir.
mse.ingress.kubernetes.io/route-limit-burst-multiplier Ingress MSE'ye özel Burst limiti çarpanını ayarlar. Varsayılan: 5.

Hız sınırlama (genel, önerilen)

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/rate-limit Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Bir rotada genel hız sınırlama için maksimum RPS değerini ayarlar.
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Hız sınırlama tetiklendiğinde döndürülen HTTP yanıt kodunu ayarlar. Varsayılan: 429. mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url ile birbirini dışlar.
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body-type Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Hız sınırlama yanıt gövdesinin biçimini ayarlar. Varsayılan: text. text ayarlandığında Content-Type: text/plain; charset=UTF-8 döndürülür. JSON ayarlandığında Content-Type: application/json; charset=UTF-8 döndürülür.
mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Hız sınırlama yanıtının gövde içeriğini ayarlar. Varsayılan: sentinel rate limited.
mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Hız sınırlama tetiklendiğinde istekleri belirtilen URL'ye yönlendirir. mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code ile birbirini dışlar.

Eşzamanlılık kontrolü (genel)

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/concurrency-limit Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Bir rotadaki maksimum eşzamanlı istek sayısını ayarlar.
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Eşzamanlılık kontrolü tetiklendiğinde HTTP yanıt kodunu ayarlar. Varsayılan: 429. mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url ile birbirini dışlar.
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body-type Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Eşzamanlılık sınırı yanıt gövdesinin biçimini ayarlar. Varsayılan: text. text ayarlandığında Content-Type: text/plain; charset=UTF-8 döndürülür. JSON ayarlandığında Content-Type: application/json; charset=UTF-8 döndürülür.
mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Eşzamanlılık sınırı yanıtının gövde içeriğini ayarlar. Varsayılan: sentinel rate limited.
mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url Ingress MSE'ye özel (ağ geçidi V1.2.25 veya üzeri gerekir) Eşzamanlılık kontrolü tetiklendiğinde istekleri belirtilen URL'ye yönlendirir. mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code ile birbirini dışlar.

Arka uç protokolü

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/backend-protocol Service Kısmen uyumlu — AJP ve FCGI desteklenmez Arka uç hizmetleriyle iletişim için kullanılan protokolü ayarlar. Varsayılan: HTTP. Desteklenen değerler: HTTP, HTTP2, HTTPS, gRPC, gRPCS.

Yük dengeleme

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/load-balance Service Kısmen uyumlu — Exponentially Weighted Moving Average (EWMA) algoritması desteklenmez ve round-robin'e geri döner Yük dengeleme algoritmasını ayarlar. Varsayılan: round_robin. Desteklenen değerler: round_robin, least_conn, random.
nginx.ingress.kubernetes.io/upstream-hash-by Service Kısmen uyumlu — NGINX değişkenlerinin sabitlerle birleştirilmesi desteklenmez Tutarlı karma hashlemeyi etkinleştirir. Desteklenen karma anahtar türleri: $request_uri (yol parametreleri dahil istek yolu), $host (istek ana bilgisayar adı), $remote_addr (istemci IP adresi), $http_<headerName> (istek üst bilgi değeri), $arg_<varName> (URL sorgu parametresi değeri).

Hizmet ısınması (graceful start)

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/warmup Service MSE'ye özel Isınma süresini saniye cinsinden ayarlar. Varsayılan olarak devre dışıdır. Yalnızca round_robin ve least_conn yük dengeleme algoritmalarıyla desteklenir.

Çerez benzeşimi

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/affinity Service Uyumlu Benzeşim türünü ayarlar. Tek geçerli değer cookie değeridir.
nginx.ingress.kubernetes.io/affinity-mode Service Kısmen uyumlu — persistent modu desteklenmez Benzeşim modunu ayarlar. Tek geçerli değer balanced değeridir.
nginx.ingress.kubernetes.io/session-cookie-name Service Uyumlu Oturum benzeşimi için karma anahtarı olarak kullanılan çerez adını ayarlar.
nginx.ingress.kubernetes.io/session-cookie-path Service Uyumlu Oluşturulan oturum çerezinin yol özniteliğini ayarlar. Varsayılan: /.
nginx.ingress.kubernetes.io/session-cookie-max-age Service Uyumlu Oluşturulan oturum çerezinin Max-Age değerini saniye cinsinden ayarlar. Varsayılan olarak oturum düzeyinde sona erme geçerlidir.
nginx.ingress.kubernetes.io/session-cookie-expires Service Uyumlu Oluşturulan oturum çerezinin Expires özniteliğini saniye cinsinden ayarlar. Varsayılan olarak oturum düzeyinde sona erme geçerlidir.

IP adresi tabanlı erişim kontrolü

Rota düzeyindeki izin listeleri, domain düzeyindeki izin listelerine göre önceliklidir. Rota düzeyindeki engelleme listeleri, domain düzeyindeki engelleme listelerine göre önceliklidir.

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/whitelist-source-range Ingress Uyumlu Rota için bir IP izin listesi ayarlar. Virgülle ayrılmış IP adreslerini ve CIDR bloklarını kabul eder.
nginx.ingress.kubernetes.io/denylist-source-range Ingress Uyumlu (ağ geçidi V1.2.31 veya üzeri gerekir) Rota için bir IP engelleme listesi ayarlar. Virgülle ayrılmış IP adreslerini ve CIDR bloklarını kabul eder. mse.ingress.kubernetes.io/blacklist-source-range öğesine göre önceliklidir.
mse.ingress.kubernetes.io/blacklist-source-range Ingress MSE'ye özel Rota için bir IP engelleme listesi ayarlar. Virgülle ayrılmış IP adreslerini ve CIDR bloklarını kabul eder.
mse.ingress.kubernetes.io/domain-whitelist-source-range Ingress MSE'ye özel Domain düzeyinde bir IP izin listesi ayarlar. Virgülle ayrılmış IP adreslerini ve CIDR bloklarını kabul eder.
mse.ingress.kubernetes.io/domain-blacklist-source-range Ingress MSE'ye özel Domain düzeyinde bir IP engelleme listesi ayarlar. Virgülle ayrılmış IP adreslerini ve CIDR bloklarını kabul eder.

Bağlantı havuzu (ağ geçidinden arka uca)

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/connection-policy-tcp-max-connection Service MSE'ye özel Ağ geçidi ile arka uç hizmeti arasındaki maksimum TCP bağlantı sayısını ayarlar.
mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint Service MSE'ye özel Ağ geçidi ile tek bir arka uç podu arasındaki maksimum TCP bağlantı sayısını ayarlar.
mse.ingress.kubernetes.io/connection-policy-http-max-request-per-connection Service MSE'ye özel Ağ geçidi ile arka uç hizmeti arasındaki bağlantı başına maksimum HTTP istek sayısını ayarlar.

Güvenlik koruma

İstemciler ve ağ geçidi arasında TLS

Ek Açıklama Kapsam Destek durumu Açıklama
mse.ingress.kubernetes.io/tls-min-protocol-version Domain MSE'ye özel Minimum TLS sürümünü ayarlar. Varsayılan: TLSv1.0. Geçerli değerler: TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3.
mse.ingress.kubernetes.io/tls-max-protocol-version Domain MSE'ye özel Maksimum TLS sürümünü ayarlar. Varsayılan: TLSv1.3. Geçerli değerler: TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3.
nginx.ingress.kubernetes.io/ssl-cipher Domain Uyumlu TLS şifreleme paketlerini virgülle ayrılmış şekilde ayarlar. Yalnızca TLS 1.0–1.2 el sıkışmaları için etkili olur. Varsayılan şifreleme paketleri: ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA, ECDHE-RSA-AES128-SHA, AES128-GCM-SHA256, AES128-SHA, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES256-SHA, ECDHE-RSA-AES256-SHA, AES256-GCM-SHA384, AES256-SHA.
mse.ingress.kubernetes.io/auth-tls-secret Domain Kısmen uyumlu — gizli dizi adı <domain-certificate-secret-name>-cacert biçimini izlemelidir Ağ geçidinin mutual TLS (mTLS) el sıkışmaları sırasında istemci sertifikalarını doğrulamak için kullandığı CA sertifikasını belirtir.

Ağ geçidi ve arka uç hizmetleri arasında TLS

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/proxy-ssl-secret Service Uyumlu Ağ geçidinin TLS el sıkışmaları sırasında arka uç hizmetlerine sunduğu istemci sertifikasını belirtir.
nginx.ingress.kubernetes.io/proxy-ssl-name Service Uyumlu Arka uçla yapılan TLS el sıkışması sırasında kullanılan Server Name Indication (SNI) değerini ayarlar.
nginx.ingress.kubernetes.io/proxy-ssl-server-name Service Uyumlu Arka uçla yapılan TLS el sıkışması sırasında SNI'nin etkinleştirilip devre dışı bırakılacağını belirler.

Kimlik doğrulama

Temel kimlik doğrulama

Ek Açıklama Kapsam Destek durumu Açıklama
nginx.ingress.kubernetes.io/auth-type Ingress Kısmen uyumlu — yalnızca basic kimlik doğrulama desteklenir Kimlik doğrulama türünü ayarlar.
nginx.ingress.kubernetes.io/auth-secret Ingress Uyumlu Rota için kimlik bilgilerini içeren gizli diziyi belirtir. Biçim: <namespace>/<name>.
nginx.ingress.kubernetes.io/auth-secret-type Ingress Uyumlu Gizli dizi verilerinin biçimini ayarlar. auth-file: auth anahtarı satır başına ayrılmış username:password çiftlerini tutar. auth-map: her anahtar bir kullanıcı adıdır ve değeri şifredir.
nginx.ingress.kubernetes.io/auth-realm Ingress Uyumlu Kimlik doğrulama realm'ini ayarlar. Kimlik bilgileri bir realm içinde paylaşılır.

NGINX Ingress ek açıklamalarının tam listesi için Annotations bölümüne bakın.