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.