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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
Üstbilgi veya sorgu parametresi tabanlı (en yüksek öncelik)
Çerez tabanlı
Ağırlık tabanlı (en düşük öncelik)
Üstbilgi tabanlı canary yayınlama
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ö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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ü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
|
|
|
|
|
|
|
|
|
|
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ı
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
""veyabase:opensergo.io/canaryetiket öneki olmayan veyaopensergo.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ğinopensergo.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-labelsayarlandığında, alt küme artıkopensergo.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).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MSE Ingress, hemssl-redirecthem deforce-ssl-redirectaçı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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
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ü
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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ıylanon_idempotentdeğeriniproxy-next-upstreamek 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
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.
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Yansıtılan trafik hedef hizmete iletildiğinde-shadowsonekiHostüstbilgisine otomatik olarak eklenir. Örneğin,example.comdeğeriexample.com-shadowhaline 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ğındagrpcveyahttp2adlı bir bağlantı noktası varsa MSE Ingress,backend-protocolaçı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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ü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ı
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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