Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Advanced usage of MSE Ingress

Son Güncelleme:Oct 09, 2026

MSE Ingress, bir Kubernetes kümesindeki hizmetlere yönelik harici erişimi yönetmek için 7. Katman yük dengeleme sağlar. Canary yayınlamadan hız sınırlamaya, TLS'den trafik yansıtılmaya kadar Ingress kaynaklarında ek açıklama tabanlı özellikleri yapılandırın.

Tüm örnekler hem Kubernetes v1.19+ (networking.k8s.io/v1) hem de önceki sürümler (networking.k8s.io/v1beta1) için yapılandırmalar içerir.

Ek açıklama hızlı referansı

Bu belgedeki tüm ek açıklamalar nginx.ingress.kubernetes.io/ veya mse.ingress.kubernetes.io/ önekini kullanır. Aşağıdaki tabloda her ek açıklama kabul edilen değerleri, varsayılanı ve kapsamıyla birlikte listelenmiştir.


Ek Açıklama


Kabul Edilen Değerler


Varsayılan


Kapsam


nginx.ingress.kubernetes.io/canary


"true"


—


Rota


nginx.ingress.kubernetes.io/canary-by-header


dize


—


Rota


nginx.ingress.kubernetes.io/canary-by-header-value


dize


—


Rota


nginx.ingress.kubernetes.io/canary-by-cookie


dize


—


Rota


nginx.ingress.kubernetes.io/canary-weight


tamsayı (0–100 veya 0–toplam)


—


Rota


nginx.ingress.kubernetes.io/canary-weight-total


tamsayı


100


Rota


mse.ingress.kubernetes.io/canary-by-query


dize


—


Rota


mse.ingress.kubernetes.io/canary-by-query-value


dize


—


Rota


mse.ingress.kubernetes.io/service-subset


dize


—


Rota


mse.ingress.kubernetes.io/subset-labels


anahtar değer


—


Rota


nginx.ingress.kubernetes.io/enable-cors


"true" / "false"


false


Rota


nginx.ingress.kubernetes.io/cors-allow-origin


virgülle ayrılmış kaynaklar veya *


*


Rota


nginx.ingress.kubernetes.io/cors-allow-methods


virgülle ayrılmış HTTP yöntemleri veya *


GET,PUT,POST,DELETE,PATCH,OPTIONS


Rota


nginx.ingress.kubernetes.io/cors-allow-headers


virgülle ayrılmış üstbilgiler veya *


DNT,X-CustomHeader,...


Rota


nginx.ingress.kubernetes.io/cors-expose-headers


virgülle ayrılmış üstbilgiler


—


Rota


nginx.ingress.kubernetes.io/cors-allow-credentials


"true" / "false"


true


Rota


nginx.ingress.kubernetes.io/cors-max-age


tamsayı (saniye)


1728000


Rota


nginx.ingress.kubernetes.io/use-regex


"true" / "false"


—


Rota


nginx.ingress.kubernetes.io/rewrite-target


yol dizesi


—


Rota


nginx.ingress.kubernetes.io/upstream-vhost


ana bilgisayar adı


—


Rota


nginx.ingress.kubernetes.io/ssl-redirect


"true" / "false"


false


Rota


nginx.ingress.kubernetes.io/force-ssl-redirect


"true" / "false"


false


Rota


nginx.ingress.kubernetes.io/permanent-redirect


URL (şema ile)


—


Rota


nginx.ingress.kubernetes.io/permanent-redirect-code


HTTP durum kodu


301


Rota


nginx.ingress.kubernetes.io/temporal-redirect


URL (şema ile)


—


Rota


mse.ingress.kubernetes.io/request-header-control-add


anahtar değer veya YAML bloğu


—


Rota


mse.ingress.kubernetes.io/request-header-control-update


anahtar değer veya YAML bloğu


—


Rota


mse.ingress.kubernetes.io/request-header-control-remove


virgülle ayrılmış üstbilgi adları


—


Rota


mse.ingress.kubernetes.io/response-header-control-add


anahtar değer veya YAML bloğu


—


Rota


mse.ingress.kubernetes.io/response-header-control-update


anahtar değer veya YAML bloğu


—


Rota


mse.ingress.kubernetes.io/response-header-control-remove


virgülle ayrılmış üstbilgi adları


—


Rota


nginx.ingress.kubernetes.io/proxy-next-upstream-tries


tamsayı


3


Rota


nginx.ingress.kubernetes.io/proxy-next-upstream-timeout


tamsayı (saniye)


zaman aşımı yok


Rota


nginx.ingress.kubernetes.io/proxy-next-upstream


virgülle ayrılmış koşullar


error,timeout


Rota


nginx.ingress.kubernetes.io/whitelist-source-range


virgülle ayrılmış IP'ler veya CIDR'ler


—


Rota


mse.ingress.kubernetes.io/blacklist-source-range


virgülle ayrılmış IP'ler veya CIDR'ler


—


Rota


mse.ingress.kubernetes.io/domain-whitelist-source-range


virgülle ayrılmış IP'ler veya CIDR'ler


—


Etki Alanı


mse.ingress.kubernetes.io/domain-blacklist-source-range


virgülle ayrılmış IP'ler veya CIDR'ler


—


Etki Alanı


mse.ingress.kubernetes.io/route-limit-rpm


tamsayı


—


Rota


mse.ingress.kubernetes.io/route-limit-rps


tamsayı


—


Rota


mse.ingress.kubernetes.io/route-limit-burst-multiplier


tamsayı


5


Rota


mse.ingress.kubernetes.io/rate-limit


tamsayı (RPS)


—


Rota


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code


HTTP durum kodu


429


Rota


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body-type


text / json


text


Rota


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body


dize


sentinel rate limited


Rota


mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url


URL


—


Rota


mse.ingress.kubernetes.io/concurrency-limit


tamsayı


—


Rota


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code


HTTP durum kodu


429


Rota


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body-type


text / json


text


Rota


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body


dize


sentinel rate limited


Rota


mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url


URL


—


Rota


mse.ingress.kubernetes.io/mirror-target-service


ad_alanı/ad:bğlantı_noktası


—


Rota


mse.ingress.kubernetes.io/mirror-percentage


tamsayı (0–100)


100


Rota


nginx.ingress.kubernetes.io/backend-protocol


HTTPS / GRPC


—


Rota


nginx.ingress.kubernetes.io/load-balance


round_robin / least_conn / random


round_robin


Rota


nginx.ingress.kubernetes.io/upstream-hash-by


NGINX değişkeni veya ifadesi


—


Rota


mse.ingress.kubernetes.io/warmup


tamsayı (saniye)


devre dışı


Rota


nginx.ingress.kubernetes.io/affinity


cookie


—


Rota


nginx.ingress.kubernetes.io/affinity-mode


balanced


balanced


Rota


nginx.ingress.kubernetes.io/session-cookie-name


dize


INGRESSCOOKIE


Rota


nginx.ingress.kubernetes.io/session-cookie-path


yol dizesi


/


Rota


nginx.ingress.kubernetes.io/session-cookie-max-age


tamsayı (saniye)


oturum kapsamında


Rota


nginx.ingress.kubernetes.io/session-cookie-expires


tamsayı (saniye)


oturum kapsamında


Rota


mse.ingress.kubernetes.io/connection-policy-tcp-max-connection


tamsayı


—


Rota


mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint


tamsayı


—


Rota


mse.ingress.kubernetes.io/connection-policy-http-max-request-per-connection


tamsayı


—


Rota


mse.ingress.kubernetes.io/tls-min-protocol-version


TLSv1.0 / TLSv1.1 / TLSv1.2 / TLSv1.3


TLSv1.0


Etki Alanı


mse.ingress.kubernetes.io/tls-max-protocol-version


TLSv1.0 / TLSv1.1 / TLSv1.2 / TLSv1.3


TLSv1.3


Etki Alanı


nginx.ingress.kubernetes.io/ssl-cipher


virgülle ayrılmış şifre paketleri


varsayılanlara bakın


Etki Alanı


nginx.ingress.kubernetes.io/proxy-ssl-secret


ad_alanı/gizli_dizi_adı


—


Rota


nginx.ingress.kubernetes.io/proxy-ssl-name


ana bilgisayar adı


—


Rota


nginx.ingress.kubernetes.io/proxy-ssl-server-name


"on" / "off"


—


Rota

Canary yayınlama

MSE Ingress dört canary yayınlama stratejisini destekler. Herhangi bir Ingress kaynağında canary özelliğini etkinleştirmek için nginx.ingress.kubernetes.io/canary: "true" ek açıklamasını ekleyin. Ardından aşağıdaki stratejiye özel ek açıklamalardan birini veya birkaçını uygulayın.

MSE Ingress, tek bir canary yayınlamada iki hizmet sürümünden fazlasını, üst sınır olmadan destekler. NGINX Ingress ve ALB Ingress ise en fazla iki sürümü destekler.

Birden çok strateji aynı anda yapılandırıldığında, MSE Ingress bunları şu öncelik sırasına göre uygular:

  1. Üstbilgi veya sorgu parametresi tabanlı (en yüksek öncelik)

  2. Çerez tabanlı

  3. Ağırlık tabanlı (en düşük öncelik)

Üstbilgi tabanlı canary yayınlama


Ek Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/canary-by-header


Belirtilen üstbilgi mevcut olduğunda ve always olarak ayarlandığında istekleri canary sürümüne yönlendirir.


—


Evet (üstbilgi tabanlı canary için)


nginx.ingress.kubernetes.io/canary-by-header-value


İstekleri yalnızca üstbilgi hem anahtara (canary-by-header içinden) hem de bu değere uyduğunda canary sürümüne yönlendirir.


—


Hayır

Örnek 1: Üstbilgi varlığına göre yönlendirme

İstek üstbilgisi mse değeri always olarak ayarlandığında, istekler demo-service-canary hizmetine gider. Diğer tüm istekler demo-service hizmetine yönlendirilir.

Kubernetes v1.19+:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Örnek 2: Tam eşleşen üstbilgi değerine göre birden çok canary sürümünü yönlendirme

mse: v1 üstbilgisi mevcutsa istekler demo-service-canary-v1 hizmetine gider. mse: v2 mevcutsa demo-service-canary-v2 hizmetine yönlendirilir. Diğer tüm istekler demo-service hizmetine gider.

Kubernetes v1.19+:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary-v1
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v2"
  name: demo-canary-v2
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary-v2
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary-v1
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v2"
  name: demo-canary-v2
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary-v2
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Sorgu parametresi tabanlı canary yayınlama


Ek Açıklama


Açıklama


Varsayılan


Zorunlu


mse.ingress.kubernetes.io/canary-by-query


Belirtilen sorgu parametresi mevcut olduğunda ve always olarak ayarlandığında istekleri canary sürümüne yönlendirir.


—


Evet (sorgu tabanlı canary için)


mse.ingress.kubernetes.io/canary-by-query-value


İstekleri yalnızca sorgu parametresi hem anahtara hem de bu değere uyduğunda canary sürümüne yönlendirir.


—


Hayır

Üstbilgi tabanlı ve sorgu parametresi tabanlı koşullar birleştirilebilir. İstekler yalnızca her iki koşul da aynı anda eşleştiğinde canary sürümüne gönderilir.

Örnek 1: Sorgu parametresi değerine göre yönlendirme

URL canary=gray parametresini içerdiğinde istekler demo-service-canary hizmetine gider. Diğer tüm istekler demo-service hizmetine yönlendirilir.

Kubernetes v1.19+:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    mse.ingress.kubernetes.io/canary-by-query: "canary"
    mse.ingress.kubernetes.io/canary-by-query-value: "gray"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    mse.ingress.kubernetes.io/canary-by-query: "canary"
    mse.ingress.kubernetes.io/canary-by-query-value: "gray"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Örnek 2: Sorgu parametresini üstbilgi koşullarıyla birleştirme

URL canary=gray parametresini VE istek üstbilgisi x-user-id: test değerini içerdiğinde istekler demo-service-canary hizmetine gider. Her iki koşulun da eşleşmesi gerekir.

Kubernetes v1.19+:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    mse.ingress.kubernetes.io/canary-by-query: "canary"
    mse.ingress.kubernetes.io/canary-by-query-value: "gray"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    mse.ingress.kubernetes.io/canary-by-query: "canary"
    mse.ingress.kubernetes.io/canary-by-query-value: "gray"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Çerez tabanlı canary yayınlama


Ek Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/canary-by-cookie


Belirtilen çerez always olarak ayarlandığında istekleri canary sürümüne yönlendirir. Özel çerez değerleri desteklenmez; değer mutlaka always olmalıdır.


—


Evet (çerez tabanlı canary için)

Example: İstek çerezi demo=always mevcut olduğunda istekler demo-service-canary hizmetine gider. Diğer tüm istekler demo-service hizmetine yönlendirilir.

Kubernetes v1.19+:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-cookie: "demo"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-cookie: "demo"
  name: demo-canary
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Ağırlık tabanlı canary dağıtımı


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/canary-weight


Canary sürümüne gönderilen isteklerin yüzdesi. 0–100 aralığında bir tamsayıdır (veya 0–canary-weight-total).


—


Evet (ağırlık tabanlı canary için)


nginx.ingress.kubernetes.io/canary-weight-total


İstek dağılımı hesaplanırken payda olarak kullanılan toplam ağırlık.


100


Hayır

Example: Trafiği üç sürüm arasında dağıtın: %30 demo-service-canary-v1 hizmetine, %20 demo-service-canary-v2 hizmetine ve %50 demo-service hizmetine yönlendirilir.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-weight: "30"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary-v1
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-weight: "20"
  name: demo-canary-v2
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary-v2
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-weight: "30"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary-v1
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-weight: "20"
  name: demo-canary-v2
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary-v2
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Hizmet alt kümesi

Hizmet alt kümesi, tek bir Kubernetes hizmeti içindeki belirli bir Pod grubuna istek yönlendirmenize olanak tanır. Bu özellik, tek bir hizmetin farklı sürümleri çalıştıran birden fazla Dağıtım tarafından desteklendiği durumlarda kullanışlıdır. MSE Ingress, alt kümeleri tanımlamak için iki yöntem sunar.

MseIngressConfig içinde Pod etiketlerini kullanma

Podları OpenSergo canary etiketlerine göre seçmek için mse.ingress.kubernetes.io/service-subset açıklamasını kullanın:

  • "" veya base: opensergo.io/canary etiket öneki olmayan veya opensergo.io/canary: "" değerine sahip Pod'lara yönlendirir.

  • Başka herhangi bir değer (örneğin gray): opensergo.io/canary-{value}: {value} şeklinde etiketlenmiş Pod'lara yönlendirir; örneğin opensergo.io/canary-gray: gray.

Example: go-httpbin adlı bir hizmet, iki Dağıtım tarafından desteklenmektedir. Temel Pod'ların OpenSergo canary etiketi yoktur. Gri (gray) Pod'lar ise opensergo.io/canary-gray: gray etiketine sahiptir.

Hizmet ve Dağıtım bildirimleri:

# go-httpbin Service
apiVersion: v1
kind: Service
metadata:
  name: go-httpbin
  namespace: default
spec:
  ports:
    - port: 8080
      protocol: TCP
  selector:
    app: go-httpbin
---
# Base Deployment — no OpenSergo canary label
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin-base
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/mse/go-httpbin
          args:
            - "--version=base"
          imagePullPolicy: Always
          name: go-httpbin
---
# Gray Deployment — has the OpenSergo canary label
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin-gray
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
        opensergo.io/canary-gray: gray
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/mse/go-httpbin
          args:
            - "--version=gray"
          imagePullPolicy: Always
          name: go-httpbin

Ingress yapılandırması — x-user-id: test başlığına sahip istekler go-httpbin-gray hizmetine; diğer tüm istekler ise go-httpbin-base hizmetine yönlendirilir:

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
    # Forward to Pods labeled opensergo.io/canary-gray: gray
    mse.ingress.kubernetes.io/service-subset: gray
  name: demo-canary
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: go-httpbin
                port:
                  number: 8080
            path: /test
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    # Forward to Pods without the opensergo.io/canary label prefix
    mse.ingress.kubernetes.io/service-subset: ""
  name: demo
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: go-httpbin
                port:
                  number: 8080
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
    # Forward to Pods labeled opensergo.io/canary-gray: gray
    mse.ingress.kubernetes.io/service-subset: gray
  name: demo-canary
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /test
            backend:
              serviceName: go-httpbin
              servicePort: 8080
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    # Forward to Pods without the opensergo.io/canary label prefix
    mse.ingress.kubernetes.io/service-subset: ""
  name: demo
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /test
            backend:
              serviceName: go-httpbin
              servicePort: 8080

Özel etiketleri kullanma

Alt kümeyi opensergo.io/canary öneki yerine herhangi bir Pod etiketiyle tanımlamak için mse.ingress.kubernetes.io/service-subset açıklamasını mse.ingress.kubernetes.io/subset-labels ile birlikte kullanın.

subset-labels ayarlandığında, alt küme artık opensergo.io/canary önekli etiketlerle eşleştirilmez.

Example: Gri (gray) Dağıtım, bir OpenSergo etiketi yerine version: gray etiketine sahiptir.

Hizmet ve Dağıtım bildirimleri:

# go-httpbin Service
apiVersion: v1
kind: Service
metadata:
  name: go-httpbin
  namespace: default
spec:
  ports:
    - port: 8080
      protocol: TCP
  selector:
    app: go-httpbin
---
# Base Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin-base
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/mse/go-httpbin
          args:
            - "--version=base"
          imagePullPolicy: Always
          name: go-httpbin
---
# Gray Deployment — uses a custom label instead of opensergo.io/canary
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin-gray
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
        version: gray
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/mse/go-httpbin
          args:
            - "--version=gray"
          imagePullPolicy: Always
          name: go-httpbin

Ingress yapılandırması — x-user-id: test başlığına sahip istekler go-httpbin-gray hizmetine; diğer tüm istekler ise go-httpbin-base hizmetine yönlendirilir:

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
    # Forward to Pods labeled version: gray
    mse.ingress.kubernetes.io/service-subset: gray
    mse.ingress.kubernetes.io/subset-labels: version gray
  name: demo-canary
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: go-httpbin
                port:
                  number: 8080
            path: /test
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/service-subset: ""
  name: demo
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: go-httpbin
                port:
                  number: 8080
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "x-user-id"
    nginx.ingress.kubernetes.io/canary-by-header-value: "test"
    # Forward to Pods labeled version: gray
    mse.ingress.kubernetes.io/service-subset: gray
    mse.ingress.kubernetes.io/subset-labels: version gray
  name: demo-canary
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /test
            backend:
              serviceName: go-httpbin
              servicePort: 8080
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/service-subset: ""
  name: demo
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /test
            backend:
              serviceName: go-httpbin
              servicePort: 8080

CORS

Cross-Origin Resource Sharing (CORS), web uygulamalarının farklı bir kaynaktaki kaynaklara erişmesine olanak tanır. CORS belirtimi için bkz. Cross-Origin Resource Sharing (CORS).


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/enable-cors


Bu Ingress üzerinde CORS'u etkinleştirir.


false


Evet (CORS'u etkinleştirmek için)


nginx.ingress.kubernetes.io/cors-allow-origin


İzin verilen üçüncü taraf kaynakları. Virgülle ayrılmış değerleri ve joker karakterleri (*) kabul eder.


*


Hayır


nginx.ingress.kubernetes.io/cors-allow-methods


İzin verilen HTTP yöntemleri. Virgülle ayrılmış değerleri ve joker karakterleri (*) kabul eder.


GET,PUT,POST,DELETE,PATCH,OPTIONS


Hayır


nginx.ingress.kubernetes.io/cors-allow-headers


İzin verilen istek başlıkları. Virgülle ayrılmış değerleri ve joker karakterleri (*) kabul eder.


DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization


Hayır


nginx.ingress.kubernetes.io/cors-expose-headers


Tarayıcıya gösterilen yanıt başlıkları. Virgülle ayrılmış değerleri kabul eder.


—


Hayır


nginx.ingress.kubernetes.io/cors-allow-credentials


CORS isteklerinde kimlik bilgilerinin dahil edilip edilemeyeceğini belirler.


true


Hayır


nginx.ingress.kubernetes.io/cors-max-age


Ön uçuş (preflight) sonuçlarının önbelleğe alınma süresi (saniye cinsinden).


1728000


Hayır

Example: Kaynak olarak example.com adresine izin verin, yöntemleri GET ve POST ile sınırlayın, X-Foo-Bar istek başlığına izin verin ve kimlik bilgisi aktarımını devre dışı bırakın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"
    nginx.ingress.kubernetes.io/cors-allow-origin: "example.com"
    nginx.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
    nginx.ingress.kubernetes.io/cors-allow-headers: "X-Foo-Bar"
    nginx.ingress.kubernetes.io/cors-allow-credentials: "false"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"
    nginx.ingress.kubernetes.io/cors-allow-origin: "example.com"
    nginx.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
    nginx.ingress.kubernetes.io/cors-allow-headers: "X-Foo-Bar"
    nginx.ingress.kubernetes.io/cors-allow-credentials: "false"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Düzenli ifade eşleşmesi

MSE Ingress, tam ve ön ek eşleşmelerine ek olarak düzenli ifade (regex) eşleşmesini de destekler. Ingress spesifikasyonunda tanımlanan yolu bir düzenli ifade olarak işlemek için nginx.ingress.kubernetes.io/use-regex: "true" ayarını yapın.

Example: Yolu /app veya /test ile başlayan example.com adresine yapılan istekleri demo hizmetine iletin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/use-regex: 'true'
  name: regex-match
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo
                port:
                  number: 8080
            path: /(app|test)/(.*)
            pathType: Prefix

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/use-regex: 'true'
  name: regex-match
  namespace: default
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /(app|test)/(.*)
            backend:
              serviceName: demo
              servicePort: 8080

Yol ve ana bilgisayar yeniden yazma

Yeniden yazma işlemleri, bir istek arka uç hizmetine ulaşmadan önce yoldaki veya ana bilgisayardaki bilgileri değiştirir.


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/rewrite-target


Hedef yol. Ingress yol desenindeki yakalama gruplarını destekler.


—


Evet (yol yeniden yazma için)


nginx.ingress.kubernetes.io/upstream-vhost


Hedef ana bilgisayar.


—


Evet (ana bilgisayar yeniden yazma için)

Yol yeniden yazma

Example 1: Arka uca iletmeden önce example.com/test adresini example.com/dev olarak yeniden yazın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/dev"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/dev"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /test
            pathType: Exact
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: /v1 ön ekini kaldırın; example.com/v1/xxx adresini example.com/xxx olarak yeniden yazın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/$1"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /v1/(.*)
            pathType: Prefix

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/$1"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /v1/(.*)
            pathType: Prefix
            backend:
              serviceName: demo-service
              servicePort: 80

Example 3: /v1 ön ekini /v2 ile değiştirin; example.com/v1/xxx adresini example.com/v2/xxx olarak yeniden yazın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/v2/$1"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /v1/(.*)
            pathType: Prefix

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: "/v2/$1"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /v1/(.*)
            pathType: Prefix
            backend:
              serviceName: demo-service
              servicePort: 80

Ana bilgisayar yeniden yazma

Example: example.com/test adresini arka uca iletmeden önce ana bilgisayarı example.com değerinden test.com olarak yeniden yazın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-vhost: "test.com"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-vhost: "test.com"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Yönlendirme

HTTP'den HTTPS'e yönlendirme


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/ssl-redirect


HTTP isteklerini HTTPS'e yönlendirmeye zorlar.


false


Evet (yönlendirmeyi etkinleştirmek için)


nginx.ingress.kubernetes.io/force-ssl-redirect


HTTP isteklerini HTTPS'e yönlendirmeye zorlar.


false


Evet (ssl-redirect için alternatif)

MSE Ingress, hem ssl-redirect hem de force-ssl-redirect açıklamalarını aynı şekilde değerlendirir; her ikisi de HTTP'den HTTPS'e yönlendirmeyi zorlar.

Example: http://example.com/test adresini https://example.com/test adresine yönlendirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Kalıcı yönlendirme


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/permanent-redirect


Kalıcı yönlendirme için hedef URL. Şema (http:// veya https://) içermelidir.


—


Evet (kalıcı yönlendirme için)


nginx.ingress.kubernetes.io/permanent-redirect-code


Yönlendirme için HTTP durum kodu.


301


Hayır

Example: http://example.com/test adresini http://example.com/app adresine kalıcı olarak yönlendirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/permanent-redirect: "http://example.com/app"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/permanent-redirect: "http://example.com/app"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Geçici yönlendirme


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/temporal-redirect


Geçici yönlendirme için hedef URL. Şema (http:// veya https://) içermelidir.


—


Evet (geçici yönlendirme için)

Example: http://example.com/test adresini http://example.com/app adresine geçici olarak yönlendirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/temporal-redirect: "http://example.com/app"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/temporal-redirect: "http://example.com/app"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Başlık kontrolü

Başlık kontrolü, MSE Ingress'in bir isteği arka uç hizmetine iletmeden önce istek başlıklarını ve yanıt istemciye döndürülmeden önce yanıt başlıklarını eklemenize, değiştirmenize veya kaldırmanıza olanak tanır.

İstek başlığı kontrolü


Açıklama (Annotation)


Tanım


Varsayılan


Zorunlu


mse.ingress.kubernetes.io/request-header-control-add


İsteğe bir başlık ekler. Başlık zaten varsa, değer orijinal değere eklenir. Tek bir başlık için anahtar-değer çifti kullanın. Birden çok başlık için YAML blok skalerini (|) ve her satırda bir anahtar-değer çifti kullanın.


—


Hayır


mse.ingress.kubernetes.io/request-header-control-update


İstekteki mevcut bir başlığı değiştirir. Başlık zaten varsa, değer orijinalin üzerine yazar. Söz dizimi request-header-control-add ile aynıdır.


—


Hayır


mse.ingress.kubernetes.io/request-header-control-remove


İstekten bir başlığı kaldırır. Birden çok başlık için virgülle (,) ayırın.


—


Hayır

Example 1: example.com/test adresine yapılan tüm isteklere foo: bar ve test: true başlıklarını ekleyin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/request-header-control-add: |
      foo bar
      test true
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/request-header-control-add: |
      foo bar
      test true
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: Başlık kontrolünü canary dağıtımlarıyla birleştirin. İstek başlığı mse: v1 olduğunda, istek stage: gray başlığı eklenerek demo-service-canary-v1 hizmetine gider. Diğer tüm istekler ise stage: production başlığı eklenerek demo-service hizmetine gider.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
    mse.ingress.kubernetes.io/request-header-control-add: "stage gray"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-canary-v1
                port:
                  number: 80
            path: /hello
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/request-header-control-add: "stage production"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /hello
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "mse"
    nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
    mse.ingress.kubernetes.io/request-header-control-add: "stage gray"
  name: demo-canary-v1
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service-canary-v1
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/request-header-control-add: "stage production"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - http:
        paths:
          - path: /hello
            backend:
              serviceName: demo-service
              servicePort: 80

Yanıt üstbilgisi denetimi


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/response-header-control-add


Arka uçtan gelen yanıtı istemciye iletmeden önce bir üstbilgi ekler. Üstbilgi zaten mevcutsa değer sonuna eklenir. Söz dizimi, istek üstbilgisi denetimi ile aynıdır.


—


Hayır


mse.ingress.kubernetes.io/response-header-control-update


Mevcut bir yanıt üstbilgisini değiştirir. Üstbilgi zaten varsa değer orijinal değerin üzerine yazar. Söz dizimi, istek üstbilgisi denetimi ile aynıdır.


—


Hayır


mse.ingress.kubernetes.io/response-header-control-remove


İstemciye iletmeden önce bir yanıt üstbilgisini kaldırır. Birden fazla üstbilgi için virgül (,) ile ayırın.


—


Hayır

Example: example.com/test yoluna gelen yanıtlardan req-cost-time üstbilgisini kaldırın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/response-header-control-remove: "req-cost-time"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/response-header-control-remove: "req-cost-time"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Yeniden Deneme

MSE Ingress, başarısız istekler için rota düzeyinde otomatik yeniden deneme özelliği sunar. Aşağıdaki ek açıklamalarla yeniden deneme koşullarını, sınırlarını ve zaman aşımlarını yapılandırabilirsiniz.


Ek Açıklama


Açıklama


Varsayılan


Gerekli


nginx.ingress.kubernetes.io/proxy-next-upstream-tries


Maksimum yeniden deneme sayısı.


3


Hayır


nginx.ingress.kubernetes.io/proxy-next-upstream-timeout


Tüm yeniden deneme girişimleri için toplam zaman aşımı süresi (saniye cinsinden).


Zaman aşımı yok


Hayır


nginx.ingress.kubernetes.io/proxy-next-upstream


Yeniden deneme koşulları (virgülle ayrılmış). Geçerli değerler: error (bağlantı hatası veya 5xx), timeout (bağlantı zaman aşımı veya 5xx), invalid_header (istek hatası veya 5xx), http_xxx (belirli durum kodu, örn. http_502), non_idempotent (POST ve PATCH yöntemleri için yeniden denemeyi etkinleştirir), off (yeniden denemeyi devre dışı bırakır).


error,timeout


Hayır

Varsayılan olarak MSE Ingress, diğer yeniden deneme koşulları karşılanmış olsa bile idempotent olmayan istekleri (POST, PATCH) yeniden denemez. Bu yöntemler için yeniden denemeyi etkinleştirmek amacıyla non_idempotent değerini proxy-next-upstream ek açıklamasına ekleyin.

Example: example.com/test yolu için maksimum 2 yeniden deneme ve 5 saniyelik zaman aşımı ayarlayın; yalnızca HTTP 502 durumunda yeniden deneme tetiklensin ve idempotent olmayan istekler için yeniden deneme etkin olsun.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/proxy-next-upstream-tries: "2"
    nginx.ingress.kubernetes.io/proxy-next-upstream-timeout: "5"
    nginx.ingress.kubernetes.io/proxy-next-upstream: "http_502,non_idempotent"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/proxy-next-upstream-tries: "2"
    nginx.ingress.kubernetes.io/proxy-next-upstream-timeout: "5"
    nginx.ingress.kubernetes.io/proxy-next-upstream: "http_502,non_idempotent"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

IP adresi izin listeleri (beyaz liste) ve engelleme listeleri (siyah liste)

MSE Ingress, hem rota hem de etki alanı düzeyinde IP adresi izin listeleri (beyaz liste) ve engelleme listeleri (siyah liste) destekler. Rota düzeyindeki kurallar, etki alanı düzeyindeki kurallara göre önceliklidir.

Rota düzeyinde IP denetimi


Ek Açıklama


Açıklama


Varsayılan


Gerekli


nginx.ingress.kubernetes.io/whitelist-source-range


Bu rota için izin verilen IP adresleri veya CIDR blokları. Virgülle ayrılır.


—


Hayır


mse.ingress.kubernetes.io/blacklist-source-range


Bu rota için engellenen IP adresleri veya CIDR blokları. Virgülle ayrılır.


—


Hayır

Example 1: example.com/test yoluna yalnızca 1.1.X.X adresinden erişime izin verin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/whitelist-source-range: 1.1.X.X
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/whitelist-source-range: 1.1.X.X
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: example.com/test yoluna 2.2.2.2 adresinden gelen erişimi engelleyin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/blacklist-source-range: 2.2.2.2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/blacklist-source-range: 2.2.2.2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Etki alanı düzeyinde IP denetimi


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/domain-whitelist-source-range


Bir etki alanının tüm rotaları için izin verilen IP adresleri veya CIDR blokları. Rota düzeyindeki izin listeleri önceliklidir. Virgülle ayrılır.


—


Hayır


mse.ingress.kubernetes.io/domain-blacklist-source-range


Bir etki alanının tüm rotaları için engellenen IP adresleri veya CIDR blokları. Rota düzeyindeki engelleme listeleri önceliklidir. Virgülle ayrılır.


—


Hayır

Example 1: example.com etki alanının tüm rotalarına 1.1.X.X ve 2.2.2.2 adreslerinden erişime izin verin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact
          - backend:
              service:
                name: app-service
                port:
                  number: 80
            path: /app
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80
          - path: /app
            backend:
              serviceName: app-service
              servicePort: 80

Example 2: example.com etki alanının tüm rotalarına 1.1.X.X ve 2.2.2.2 adreslerinden erişime izin verin ancak /order yolunu yalnızca 3.3.X.X adresiyle sınırlayın. /order yolundaki rota düzeyindeki izin listesi, bu rota için etki alanı düzeyindeki izin listesinin üzerine yazar.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
  name: demo-domain
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact
          - backend:
              service:
                name: app-service
                port:
                  number: 80
            path: /app
            pathType: Exact
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/whitelist-source-range: 3.3.X.X
  name: demo-route
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /order
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
  name: demo-domain
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80
          - path: /app
            backend:
              serviceName: app-service
              servicePort: 80
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/whitelist-source-range: 3.3.X.X
  name: demo-route
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /order
            backend:
              serviceName: demo-service
              servicePort: 80

Tek ağ geçidi hız sınırlama

Tek ağ geçidi hız sınırlama, bir ağ geçidi kopyası başına rota üzerindeki istek oranını sınırlar. Örnek başına hız denetimi için bu özelliği kullanın. Küme genelinde hız denetimi için bkz. Genel hız sınırlama denetimi.

MSE Ingress, ani yük denetimi için token bucket modeli kullanır. route-limit-rpm veya route-limit-rps ek açıklaması, sürdürülebilir oranı (token bucket'ın ne kadar hızlı dolduğunu) ayarlar. route-limit-burst-multiplier ek açıklaması, ani yük kapasitesini bu oranın katı olarak belirler: ani yük sınırı = oran × çarpan. Ani yük kapasitesini aşan istekler, yanıt gövdesinde local_rate_limited ile reddedilir.


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/route-limit-rpm


Ağ geçidi kopyası başına dakika başına maksimum istek sayısı (RPM). Ani yük sınırı = RPM × route-limit-burst-multiplier. Hız sınırlama durumunda döndürülen yanıt kodu: 503 (ağ geçidi < v1.2.23) veya 429 (ağ geçidi >= v1.2.23).


—


Hayır


mse.ingress.kubernetes.io/route-limit-rps


Ağ geçidi kopyası başına saniye başına maksimum istek sayısı (RPS). Ani yük sınırı = RPS × route-limit-burst-multiplier. Yanıt kodları RPM ile aynıdır.


—


Hayır


mse.ingress.kubernetes.io/route-limit-burst-multiplier


Yapılandırılmış RPM veya RPS sınırına uygulanan ani yük kapasitesi çarpanı.


5


Hayır

Example 1: example.com/test yolunu dakikada 100 istekle (RPM) ve 200'lük bir ani yük sınırıyla (çarpan = 2) sınırlayın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/route-limit-rpm: "100"
    mse.ingress.kubernetes.io/route-limit-burst-multiplier: "2"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/route-limit-rpm: "100"
    mse.ingress.kubernetes.io/route-limit-burst-multiplier: "2"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: example.com/test yolunu saniyede 10 istekle (RPS) ve varsayılan 50'lik ani yük sınırıyla (çarpan = 5) sınırlayın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/route-limit-rps: "10"
    # Default burst multiplier is 5, giving a burst limit of 50 RPS
    # mse.ingress.kubernetes.io/route-limit-burst-multiplier: "5"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/route-limit-rps: "10"
    # Default burst multiplier is 5, giving a burst limit of 50 RPS
    # mse.ingress.kubernetes.io/route-limit-burst-multiplier: "5"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Genel hız sınırlama denetimi

MSE Ingress, Sentinel ile entegre çalışarak bir ağ geçidi kümesindeki tüm kopyalar genelinde rota düzeyinde genel bir RPS sınırı uygular. Hız sınırlama tetiklendiğinde varsayılan yanıt kodu 429 ve yanıt gövdesi sentinel rate limited olur.

Önemli

Genel hız sınırlama denetimi için MSE Ingress ağ geçidi sürümü 1.2.25 veya üzeri gerekir.

Küme genelindeki hız sınırını mse.ingress.kubernetes.io/rate-limit ek açıklamasıyla yapılandırın. Hız sınırlama yanıtını özelleştirmek için iki yaklaşımdan birini seçin: özel yanıt veya yönlendirme. Aynı anda yalnızca bir yaklaşım etkin olabilir.

Özel yanıt


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/rate-limit


Tüm ağ geçidi kümesi genelinde bu rota için maksimum RPS.


—


Evet


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code


Hız sınırlama tetiklendiğinde döndürülen HTTP yanıt kodu.


429


Hayır


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body-type


Yanıt gövdesi içerik türü. text değeri Content-Type: text/plain; charset=UTF-8 olarak ayarlar. json değeri Content-Type: application/json; charset=UTF-8 olarak ayarlar.


text


Hayır


mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body


Hız sınırlama tetiklendiğinde döndürülen yanıt gövdesi içeriği.


sentinel rate limited


Hayır

Example 1: example.com/test yolunu küme genelinde saniyede 100 istekle (RPS) sınırlayın ve varsayılan yanıtı (HTTP 429, sentinel rate limited) kullanın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: example.com/test yolunu küme genelinde saniyede 100 istekle (RPS) sınırlayın. Hız sınırlama tetiklendiğinde HTTP 503 yanıt kodu ve server is overloaded gövde içeriği döndürün.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
    mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body: "server is overloaded"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
    mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/rate-limit-fallback-custom-response-body: "server is overloaded"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Yönlendirme


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url


Hız sınırlama tetiklendiğinde istemcinin yönlendirileceği URL.


—


Hayır

Example: example.com/test yolunu küme genelinde saniyede 100 istekle (RPS) sınırlayın. Hız sınırlama tetiklendiğinde example.com/fallback adresine yönlendirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
    mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url: "example.com/fallback"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/rate-limit: "100"
    mse.ingress.kubernetes.io/rate-limit-fallback-redirect-url: "example.com/fallback"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Genel eşzamanlılık denetimi

MSE Ingress, Sentinel ile entegre çalışarak tüm ağ geçidi kümesi genelinde bir rota üzerindeki eşzamanlı (havada bekleyen) istek sayısını sınırlar. Sınır aşıldığında varsayılan yanıt kodu 429 ve yanıt gövdesi sentinel rate limited olur.

Önemli

Genel eşzamanlılık denetimi için MSE Ingress ağ geçidi sürümü 1.2.25 veya üzeri gerekir.

Küme genelindeki eşzamanlılık sınırını mse.ingress.kubernetes.io/concurrency-limit ek açıklamasıyla yapılandırın. Sınır aşıldığında döndürülen yanıtı özelleştirmek için özel yanıt veya yönlendirme yaklaşımından birini kullanın. Aynı anda yalnızca bir yaklaşım etkin olabilir.

Özel yanıt


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/concurrency-limit


Tüm ağ geçidi kümesi genelinde bu rota için maksimum eşzamanlı (havada bekleyen) istek sayısı.


—


Evet


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code


Eşzamanlılık denetimi tetiklendiğinde döndürülen HTTP yanıt kodu.


429


Hayır


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body-type


Yanıt gövdesi içerik türü. text değeri Content-Type: text/plain; charset=UTF-8 olarak ayarlar. json değeri Content-Type: application/json; charset=UTF-8 olarak ayarlar.


text


Hayır


mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body


Eşzamanlılık denetimi tetiklendiğinde döndürülen yanıt gövdesi içeriği.


sentinel rate limited


Hayır

Example 1: example.com/test yolundaki eşzamanlı (havada bekleyen) istek sayısını küme genelinde 1.000 ile sınırlayın ve varsayılan yanıtı kullanın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: example.com/test yolundaki eşzamanlı (havada bekleyen) istek sayısını küme genelinde 1.000 ile sınırlayın. Sınır aşıldığında HTTP 503 yanıt kodu ve server is overloaded gövde içeriği döndürün.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body: "server is overloaded"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body: "server is overloaded"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Yönlendirme


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url


Eşzamanlılık denetimi tetiklendiğinde istemcinin yönlendirileceği URL.


—


Hayır

Example: example.com/test yolundaki eşzamanlı (havada bekleyen) istek sayısını küme genelinde 1.000 ile sınırlayın. Sınır aşıldığında example.com/fallback adresine yönlendirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url: "example.com/fallback"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-redirect-url: "example.com/fallback"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Trafik yansıtma

Trafik yansıtma, canlı istekleri orijinal yanıtı etkilemeden ikincil bir hizmete kopyalar. Bu özelliği, bir gölge ortamda trafiği denetlemek, test etmek veya hata ayıklamak için kullanabilirsiniz.


Ek Açıklama


Açıklama


Varsayılan


Gerekli


mse.ingress.kubernetes.io/mirror-target-service


Yansıtılan trafik için hedef hizmet. Biçim: namespace/name:port. namespace belirtilmezse ağ geçidi ad alanı varsayılan olarak kullanılır. port belirtilmezse Hizmetin ilk bağlantı noktası varsayılan olarak kullanılır.


—


Evet (yansıtmayı etkinleştirmek için)


mse.ingress.kubernetes.io/mirror-percentage


Yansıtılacak trafik yüzdesi. Geçerli aralık: 0–100.


100


Hayır

Yansıtılan trafik hedef hizmete iletildiğinde -shadow soneki Host üstbilgisine otomatik olarak eklenir. Örneğin, example.com değeri example.com-shadow haline gelir.

Example 1: example.com/test yoluna gelen isteklerin %100'ünü test/app:8080 hizmetine yansıtın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/mirror-target-service: test/app:8080
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/mirror-target-service: test/app:8080
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: example.com/test yoluna gelen isteklerin %10'unu test/app:8080 hizmetine yansıtın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/mirror-target-service: test/app:8080
    mse.ingress.kubernetes.io/mirror-percentage: 10
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/mirror-target-service: test/app:8080
    mse.ingress.kubernetes.io/mirror-percentage: 10
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Arka uç hizmet protokolleri: HTTPS ve gRPC

Varsayılan olarak MSE Ingress, istekleri arka uç konteynerlerine HTTP üzerinden iletir. HTTPS veya gRPC'ye geçiş yapmak için nginx.ingress.kubernetes.io/backend-protocol açıklamasını kullanın.

Arka ucunuzun Kubernetes Service kaynağında grpc veya http2 adlı bir bağlantı noktası varsa MSE Ingress, backend-protocol açıklamasına gerek kalmadan ilgili protokolü otomatik olarak kullanır. Bu durum, standart NGINX Ingress davranışından farklıdır.

Example 1: İstekleri HTTPS üzerinden bir arka uca iletin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: İstekleri bir gRPC arka ucuna iletin. Bunun için iki yöntem mevcuttur.

Yöntem 1 — backend-protocol açıklamasını kullanın:

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Yöntem 2 — MSE Ingress'in protokolü otomatik algılaması için Service bağlantı noktasını grpc olarak adlandırın:

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /order
            pathType: Exact
---
apiVersion: v1
kind: Service
metadata:
  name: demo-service
spec:
  ports:
    - name: grpc
      port: 80
      protocol: TCP
  selector:
    app: demo-service

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: demo-service
spec:
  ports:
    - name: grpc
      port: 80
      protocol: TCP
  selector:
    app: demo-service

Yük dengeleme algoritmaları

MSE Ingress, istekleri arka uç Pod'larına dağıtmak için çeşitli yük dengeleme algoritmalarını destekler. Trafiğinizin dağıtımına ve oturum gereksinimlerinize göre uygun olanı seçin:


Algoritma


Açıklama değeri


Açıklama


Kullanım durumu


Döngüsel (Round robin)


round_robin


İstekleri Pod'lara sırayla eşit şekilde dağıtır.


Varsayılan; durumsuz ve benzer performans gösteren arka uçlar için uygundur.


En az bağlantı (Least connections)


least_conn


Her isteği en az etkin bağlantıya sahip Pod'a yönlendirir.


İstek süreleri değişken olan arka uçlar için tercih edilir.


Rastgele (Random)


random


İstekleri rastgele seçilen bir Pod'a yönlendirir.


Durum bilgisi gerektirmeyen basit eşit dağıtım senaryolarında kullanılır.


Tutarlı karma (Consistent hashing)


Aşağıya bakın


Aynı karma anahtarına sahip istekleri aynı Pod'a yönlendirir.


IP, üstbilgi veya sorgu parametresine dayalı oturum bağlılığı gerektiğinde uygulanır.

Önemli

Üstel ağırlıklı hareketli ortalama (EWMA) algoritması desteklenmez. Yapılandırılırsa sistem döngüsel (round robin) algoritmasına geri döner.

Yaygın yük dengeleme algoritmaları


Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/load-balance


Yük dengeleme algoritması. Geçerli değerler: round_robin, least_conn, random.


round_robin


Hayır

Example: demo-service için en az bağlantı algoritmasını kullanın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/load-balance: "least_conn"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /order
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/load-balance: "least_conn"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Tutarlı karma

Tutarlı karma, aynı karma anahtarına sahip istekleri aynı arka uç Pod'una yönlendirir. MSE Ingress; NGINX değişkenleri, istek üstbilgileri veya sorgu parametreleri üzerinden karma oluşturmayı destekler.


Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/upstream-hash-by


Karma anahtarı ifadesi. Desteklenen değerler: NGINX değişkenleri (ör. $remote_addr, $host, $request_uri), istek üstbilgileri ($http_<header-name>), sorgu parametreleri ($arg_<param-name>).


—


Evet (tutarlı karma için)

Example 1: İstemci IP'sine göre karma oluşturun — aynı IP'den gelen istekler her zaman aynı Pod'a ulaşır.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$remote_addr"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$remote_addr"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: X-Stage istek üstbilgisine göre karma oluşturun — aynı X-Stage değerine sahip istekler her zaman aynı Pod'a ulaşır.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$http_x-stage"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$http_x-stage"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 3: x-stage sorgu parametresine göre karma oluşturun — aynı x-stage değerine sahip istekler her zaman aynı Pod'a ulaşır.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$arg_x-stage"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$arg_x-stage"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Isınma (kademeli başlatma)

Isınma özelliği, yeni başlatılan bir Pod'a gelen trafiği belirli bir zaman penceresi içinde kademeli olarak artırır; böylece soğuk başlayan bir Pod aniden tam yük altında kalmaz. Isınma özelliği yalnızca döngüsel (round robin) ve en az bağlantı algoritmaları tarafından desteklenir.


Açıklama


Açıklama


Varsayılan


Zorunlu


mse.ingress.kubernetes.io/warmup


Saniye cinsinden ısınma penceresi süresi. Yeni bir Pod başladığında trafik bu süre boyunca kademeli olarak artar.


Isınma devre dışı


Hayır

Example: demo-service için 30 saniyelik bir ısınma penceresi etkinleştirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/warmup: "30"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/warmup: "30"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Çerez bağlılığı (oturum kalıcılığı)

Çerez bağlılığı, ağ geçidi tarafından oluşturulan bir çerez kullanarak istemciyi ardışık isteklerde aynı arka uç Pod'una sabitler. İlk istekte MSE Ingress, yanıtta bir çerez ayarlar. Aynı istemciden gelen sonraki istekler bu çerezi içerir ve aynı Pod'a yönlendirilir.


Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/affinity


Çerez bağlılığını etkinleştirir. Tek geçerli değer cookie değeridir.


—


Evet (çerez bağlılığını etkinleştirmek için)


nginx.ingress.kubernetes.io/affinity-mode


Bağlılık modu. Tek geçerli değer balanced değeridir.


balanced


Hayır


nginx.ingress.kubernetes.io/session-cookie-name


Karma anahtarı olarak kullanılan çerezin adı.


INGRESSCOOKIE


Hayır


nginx.ingress.kubernetes.io/session-cookie-path


Oluşturulan çerezin yol özniteliği.


/


Hayır


nginx.ingress.kubernetes.io/session-cookie-max-age


Oluşturulan çerezin sona erme süresi (saniye).


Oturum kapsamı


Hayır


nginx.ingress.kubernetes.io/session-cookie-expires


Oluşturulan çerezin sona erme süresi (saniye).


Oturum kapsamı


Hayır

Example 1: Varsayılanlarla çerez bağlılığını etkinleştirin — çerez adı INGRESSCOOKIE, yol /, ömür oturum kapsamındadır.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/affinity: "cookie"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/affinity: "cookie"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Example 2: test adlı özel bir çerez, / yolu ve 10 saniyelik sona erme süresi ile çerez bağlılığını etkinleştirin.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/affinity: "cookie"
    nginx.ingress.kubernetes.io/session-cookie-name: "test"
    nginx.ingress.kubernetes.io/session-cookie-max-age: "10"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/affinity: "cookie"
    nginx.ingress.kubernetes.io/session-cookie-name: "test"
    nginx.ingress.kubernetes.io/session-cookie-max-age: "10"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Ağ geçidi ile arka uç hizmeti arasındaki bağlantı havuzu

Ağ geçidi ile arka uç hizmeti arasındaki bağlantı sayısını kontrol etmek için bir bağlantı havuzu yapılandırın. Bu yapılandırma, trafik artışları sırasında arka ucun aşırı yüklenmesini önler.


Açıklama


Açıklama


Varsayılan


Zorunlu


mse.ingress.kubernetes.io/connection-policy-tcp-max-connection


Ağ geçidi ile arka uç hizmeti arasındaki maksimum toplam TCP bağlantısı sayısı.


—


Hayır


mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint


Ağ geçidi ile arka uç hizmetinin tek bir Pod'u arasındaki maksimum TCP bağlantısı sayısı.


—


Hayır


mse.ingress.kubernetes.io/connection-policy-http-max-request-per-connection


Ağ geçidi ile arka uç hizmeti arasındaki bağlantı başına maksimum HTTP isteği sayısı.


—


Hayır

Example: demo-service için toplamda maksimum 10 bağlantı ve Pod başına 2 bağlantı ayarlayın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/connection-policy-tcp-max-connection: 10
    mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint: 2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/connection-policy-tcp-max-connection: 10
    mse.ingress.kubernetes.io/connection-policy-tcp-max-connection-per-endpoint: 2
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

TLS sürümleri ve şifre paketleri

MSE Ingress için varsayılan TLS sürüm aralığı TLSv1.0 (en eski) ile TLSv1.3 (en yeni) arasındadır. Varsayılan şifre paketleri şunlardır:

  • 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

Alan adı başına TLS ayarlarını yapılandırmak için aşağıdaki açıklamaları kullanın.


Açıklama


Açıklama


Varsayılan


Zorunlu


mse.ingress.kubernetes.io/tls-min-protocol-version


Kabul edilen en eski TLS sürümü. Geçerli değerler: TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3.


TLSv1.0


Hayır


mse.ingress.kubernetes.io/tls-max-protocol-version


Kabul edilen en yeni TLS sürümü.


TLSv1.3


Hayır


nginx.ingress.kubernetes.io/ssl-cipher


TLS şifre paketleri (virgülle ayrılmış). Yalnızca TLS 1.0–1.2 sürümleri için geçerlidir.


Yukarıdaki varsayılan listeye bakın


Hayır

Example: example.com alan adını yalnızca TLSv1.2 ile sınırlayın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/tls-min-protocol-version: "TLSv1.2"
    mse.ingress.kubernetes.io/tls-max-protocol-version: "TLSv1.2"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    mse.ingress.kubernetes.io/tls-min-protocol-version: "TLSv1.2"
    mse.ingress.kubernetes.io/tls-max-protocol-version: "TLSv1.2"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80

Ağ geçidi ile arka uç hizmeti arasında Karşılıklı TLS (mTLS)

Varsayılan olarak MSE Ingress, istekleri arka uç konteynerlerine HTTP üzerinden iletir. nginx.ingress.kubernetes.io/backend-protocol: "HTTPS" ayarlandığında MSE Ingress tek yönlü TLS kullanır: Arka ucun sertifikasını doğrular; bu sertifikanın iyi bilinen bir sertifika yetkilisi (CA) tarafından verilmiş olması gerekir.

Karşılıklı TLS (mTLS) durumunda hem ağ geçidi hem de arka uç hizmeti birbirlerinin sertifikalarını doğrular.


Açıklama


Açıklama


Varsayılan


Zorunlu


nginx.ingress.kubernetes.io/proxy-ssl-secret


Ağ geçidinin arka uca kimlik doğrulaması yapmak için kullandığı istemci sertifikası. Biçim: secretNamespace/secretName.


—


Evet (mTLS için)


nginx.ingress.kubernetes.io/proxy-ssl-name


TLS el sıkışması sırasında kullanılan Sunucu Adı Gösterimi (SNI).


—


Hayır


nginx.ingress.kubernetes.io/proxy-ssl-server-name


TLS el sıkışması sırasında SNI'nin etkinleştirilip devre dışı bırakıldığını belirtir.


—


Hayır

Example: default ad alanındaki gateway-cert kullanarak ağ geçidi ile demo-service arasında mTLS yapılandırın.

Kubernetes v1.19 ve üzeri:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/proxy-ssl-secret: "default/gateway-cert"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - backend:
              service:
                name: demo-service
                port:
                  number: 80
            path: /test
            pathType: Exact

Kubernetes v1.19 öncesi sürümler:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/proxy-ssl-secret: "default/gateway-cert"
  name: demo
spec:
  ingressClassName: mse
  rules:
    - host: example.com
      http:
        paths:
          - path: /test
            backend:
              serviceName: demo-service
              servicePort: 80