Yönlendirme, HTTPS yönlendirmesi, sağlık kontrolleri ve kademeli sürüm yayınlama (canary) için ALB Ingress açıklamalarını yapılandırın.
Ön koşullar
Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
İnternet erişimi için bir Virtual Private Cloud (VPC) ve NAT Gateway içeren bir ACK sunucusuz kümesi.
Açıklama hızlı başvuru kılavuzu
ALB Ingress özellikleri, metadata.annotations alanındaki açıklamalarla yapılandırılır. Aşağıdaki tabloda desteklenen açıklamalar kategori bazında listelenmiştir.
| Kategori | Açıklama (Annotation) | Açıklama |
|---|---|---|
| Sağlık kontrolü | alb.ingress.kubernetes.io/healthcheck-enabled |
Sağlık kontrollerini etkinleştirin veya devre dışı bırakın |
alb.ingress.kubernetes.io/healthcheck-path |
Sağlık kontrolü yolu | |
alb.ingress.kubernetes.io/healthcheck-protocol |
Protokol: HTTP, HTTPS, TCP, GRPC |
|
alb.ingress.kubernetes.io/healthcheck-httpversion |
HTTP sürümü: HTTP1.0, HTTP1.1 |
|
alb.ingress.kubernetes.io/healthcheck-method |
Yöntem: HEAD, POST, GET |
|
alb.ingress.kubernetes.io/healthcheck-code |
Beklenen durum kodu (healthcheck-httpcode öğesinden daha yüksek önceliğe sahiptir) |
|
alb.ingress.kubernetes.io/healthcheck-httpcode |
Beklenen HTTP durum kodu (1,19'dan eski kümeler için) | |
alb.ingress.kubernetes.io/healthcheck-timeout-seconds |
Saniye cinsinden zaman aşımı (1–300) | |
alb.ingress.kubernetes.io/healthcheck-interval-seconds |
Saniye cinsinden kontrol aralığı (1–50) | |
alb.ingress.kubernetes.io/healthy-threshold-count |
Sunucunun sağlıklı olarak işaretlenmesi için gereken ardışık başarılı deneme sayısı (2–10) | |
alb.ingress.kubernetes.io/unhealthy-threshold-count |
Sunucunun sağlıksız olarak işaretlenmesi için gereken ardışık başarısız deneme sayısı (2–10) | |
alb.ingress.kubernetes.io/healthcheck-connect-port |
Sağlık kontrolleri için kullanılan bağlantı noktası (0 = arka uç bağlantı noktası) | |
| TLS / HTTPS | alb.ingress.kubernetes.io/ssl-redirect |
HTTP 80 bağlantı noktasından HTTPS 443 bağlantı noktasına yönlendirme yapın |
| Arka uç protokolü | alb.ingress.kubernetes.io/backend-protocol |
Arka uç protokolü: https, grpc |
| Yol eşleşmesi | alb.ingress.kubernetes.io/use-regex |
Yol kurallarında düzenli ifadeleri etkinleştirin |
| Yeniden yazma | alb.ingress.kubernetes.io/rewrite-target |
İletmeden önce istek yolunu yeniden yazın |
| Dinleyici bağlantı noktaları | alb.ingress.kubernetes.io/listen-ports |
Özel dinleyici bağlantı noktaları, örn. [{"HTTP": 80},{"HTTPS": 443}] |
| İletim önceliği | alb.ingress.kubernetes.io/order |
İletim kuralı önceliği (1–1000; düşük değer = yüksek öncelik) |
| Kademeli sürüm yayınlama | alb.ingress.kubernetes.io/canary |
Kademeli yönlendirmeyi etkinleştirin |
alb.ingress.kubernetes.io/canary-by-header |
İstek üstbilgisi adına göre yönlendirin | |
alb.ingress.kubernetes.io/canary-by-header-value |
Tam üstbilgi değerine göre yönlendirin | |
alb.ingress.kubernetes.io/canary-by-cookie |
Çerez adına göre yönlendirin (always veya never) |
|
alb.ingress.kubernetes.io/canary-weight |
Kademeli sürüme yönlendirilecek trafik yüzdesi (0–100) | |
| Oturum kalıcılığı | alb.ingress.kubernetes.io/sticky-session |
Oturum kalıcılığını etkinleştirin |
alb.ingress.kubernetes.io/sticky-session-type |
Çerez modu: Insert veya Server |
|
alb.ingress.kubernetes.io/cookie-timeout |
Saniye cinsinden çerez zaman aşımı (1–86400) | |
alb.ingress.kubernetes.io/cookie |
Özel çerez adı (tür Server ise gereklidir) |
|
| Yük dengeleme algoritması | alb.ingress.kubernetes.io/backend-scheduler |
Algoritma: wrr, wlc, sch, uch |
alb.ingress.kubernetes.io/backend-scheduler-uch-value |
uch karma işlemi için URL parametresi adı |
|
| CORS | alb.ingress.kubernetes.io/enable-cors |
Kaynaklar Arası Kaynak Paylaşımını (CORS) etkinleştirin |
alb.ingress.kubernetes.io/cors-allow-origin |
İzin verilen kaynaklar | |
alb.ingress.kubernetes.io/cors-allow-methods |
İzin verilen HTTP yöntemleri | |
alb.ingress.kubernetes.io/cors-allow-headers |
İzin verilen istek üstbilgileri | |
alb.ingress.kubernetes.io/cors-expose-headers |
Tarayıcıya gösterilen üstbilgiler | |
alb.ingress.kubernetes.io/cors-allow-credentials |
Kimlik bilgilerinin izin verilip verilmeyeceği | |
alb.ingress.kubernetes.io/cors-max-age |
Ön talep önbellekleme süresi saniye cinsinden (−1–172800) | |
| Arka uç bağlantıları | alb.ingress.kubernetes.io/backend-keepalive |
Kalıcı arka uç bağlantılarını etkinleştirin |
| Hız sınırlama | alb.ingress.kubernetes.io/traffic-limit-qps |
İletim kuralı başına QPS sınırı (1–100.000) |
| Yavaş başlatma | alb.ingress.kubernetes.io/slow-start-enabled |
Yeni pod'lar için yavaş başlatmayı etkinleştirin |
alb.ingress.kubernetes.io/slow-start-duration |
Saniye cinsinden artış süresi (30–900) | |
| Bağlantı boşaltma | alb.ingress.kubernetes.io/connection-drain-enabled |
Bağlantı boşaltmayı etkinleştirin |
alb.ingress.kubernetes.io/connection-drain-timeout |
Saniye cinsinden boşaltma zaman aşımı (0–900) |
İstekleri etki alanı adlarına göre iletin
İstekleri etki alanı adına göre iletmek için bir Ingress oluşturun. ALB Ingress, standart ve boş etki alanı adlarını destekler.
Standart bir etki alanı adına göre istekleri iletin
Aşağıdaki örnekte yönlendirme yolu /hello olarak ayarlanmıştır. demo.domain.ingress.top/hello adresine yapılan istekler arka uç Hizmetine iletilir.
-
Bir Hizmet, Dağıtım ve Ingress oluşturmak için aşağıdaki şablonu dağıtın. İstekler, Ingress içindeki etki alanı adı aracılığıyla Hizmet'e iletilir.
-
Yönlendirmeyi test edin.
ADDRESSifadesini ALB örneği etki alanı adıyla değiştirin (almak içinkubectl get ingkomutunu çalıştırın).curl -H "host: demo.domain.ingress.top" <ADDRESS>/helloBeklenen çıktı:
{"hello":"coffee"}
Boş bir etki alanı adına göre istekleri iletin
host alanı boş bırakıldığında, Ingress etki alanından bağımsız olarak tüm istekleri eşleştirir. Aşağıdaki örnek, <ADDRESS>/hello adresine yapılan istekleri arka uç Hizmetine yönlendirir.
-
Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.
-
Yönlendirmeyi test edin.
ADDRESSifadesini ALB örneği etki alanı adıyla değiştirin.curl <ADDRESS>/helloBeklenen çıktı:
{"hello":"coffee"}
İstekleri URL yollarına göre iletin
ALB Ingress, istekleri pathType alanını kullanarak URL yollarına göre iletir. Üç eşleşme türü desteklenir:
**pathType** |
Davranış |
|---|---|
Prefix |
Büyük/küçük harfe duyarlı olarak, segment segment yol ön ekini eşleştirir |
Exact |
Yalnızca tam eşleşme |
ImplementationSpecific |
ALB Ingress denetleyicisi tarafından tam eşleşme (Exact) olarak işlenir. path ayarlanmazsa, ALB varsayılan olarak / kullanır |
pathType değeri Exact veya Prefix olarak ayarlanırsa, path boş olmayan mutlak bir yol olmalıdır. Aksi takdirde, Ingress oluşturma işlemi doğrulama hatasıyla başarısız olur. Birden fazla URL eşleşme kuralı çakıştığında, ALB bunları iletim kuralı önceliğine göre değerlendirir.
Yol eşleşme referansı
Basit yollar (/, /foo, /foo/)
| Eşleşme türü | Kural yolu | İstek yolu | Eşleşti mi? |
|---|---|---|---|
| Prefix | / |
/ (tümünü eşleştirir) |
Evet |
| Prefix | /foo |
/foo |
Evet |
| Prefix | /foo |
/foo/ |
Evet |
| Prefix | /foo/ |
/foo |
Evet |
| Prefix | /foo/ |
/foo/ |
Evet |
| Prefix | /aaa |
/ccc |
Hayır — ön ek eşleşmiyor |
| Exact veya ImplementationSpecific | /foo |
/foo |
Evet |
| Exact veya ImplementationSpecific | /foo |
/bar |
Hayır |
| Exact veya ImplementationSpecific | /foo |
/foo/ |
Hayır |
| Exact veya ImplementationSpecific | /foo/ |
/foo |
Hayır |
Hiyerarşik yollar (/aaa/bb, /aaa/bbb, /aaa/bbb/)
| Eşleşme türü | Kural yolu | İstek yolu | Eşleşti mi? |
|---|---|---|---|
| Prefix | /aaa/bb |
/aaa/bbb |
Hayır |
| Prefix | /aaa/bbb |
/aaa/bbb |
Evet |
| Prefix | /aaa/bbb/ |
/aaa/bbb |
Evet — kuraldaki sondaki eğik çizgi yok sayılır |
| Prefix | /aaa/bbb |
/aaa/bbb/ |
Evet — istekteki sondaki eğik çizgi eşleşir |
| Prefix | /aaa/bbb |
/aaa/bbb/ccc |
Evet — alt yol eşleşir |
Birden fazla kural yolu
| Eşleşme türü | Kural yolları | İstek yolu | Eşleşti mi? |
|---|---|---|---|
| Prefix | /, /aaa |
/aaa/ccc |
Evet — / ön ekiyle eşleşir |
| Prefix | /aaa, / |
/aaa/ccc |
Evet — /aaa ön ekiyle eşleşir |
| Prefix | /aaa, / |
/ccc |
Evet — / ön ekiyle eşleşir |
| Prefix | /aaa, /bbb |
/ccc |
Hayır — ön ek eşleşmiyor |
Ön ek eşleşmesi (Prefix)
Ön ek eşleştirme, / ile ayrılan yol segmentlerini büyük/küçük harfe duyarlı olarak karşılaştırır. Aşağıdaki örnekte kural yolu / olarak ayarlanmıştır; bu yol /hello dahil olmak üzere tüm yollarla eşleşir.
-
Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.
-
Yönlendirmeyi test edin.
ADDRESSifadesini ALB örneği etki alanı adıyla değiştirin.curl <ADDRESS>/helloBeklenen çıktı:
{"hello":"coffee"}
Tam eşleşme (Exact veya ImplementationSpecific)
Aşağıdaki örnekte kural yolu /hello olarak ayarlanmıştır. Yalnızca tam /hello yolu eşleşir.
-
Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.
-
Yönlendirmeyi test edin.
ADDRESSifadesini ALB örneği etki alanı adıyla değiştirin.curl <ADDRESS>/helloBeklenen çıktı:
{"hello":"coffee"}
HTTP'yi HTTPS'ye yönlendirin
HTTP isteklerini HTTPS 443 bağlantı noktasına yönlendirmek için alb.ingress.kubernetes.io/ssl-redirect: "true" açıklamasını ekleyin.
Bu açıklama yalnızca dinleyici bağlantı noktası 80 üzerindeki HTTP iletim kuralları için geçerlidir. Bu özellik yalnızca RemoveHeader, InsertHeader ve çapraz alan CORS açıklamalarıyla birlikte çalışır. Bu açıklamayı eklemeden önce AlbConfig içinde 443 bağlantı noktasında bir HTTPS dinleyicisi yapılandırın.
Kubernetes 1,19 veya sonraki sürümleri çalıştıran kümeler
apiVersion: v1
kind: Service
metadata:
name: demo-service-ssl
namespace: default
spec:
ports:
- name: port1
port: 80
protocol: TCP
targetPort: 8080
selector:
app: demo-ssl
sessionAffinity: None
type: ClusterIP
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: demo-ssl
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: demo-ssl
template:
metadata:
labels:
app: demo-ssl
spec:
containers:
- image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
imagePullPolicy: IfNotPresent
name: demo-ssl
ports:
- containerPort: 8080
protocol: TCP
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
alb.ingress.kubernetes.io/ssl-redirect: "true"
name: demo-ssl
namespace: default
spec:
ingressClassName: alb
tls:
- hosts:
- ssl.alb.ingress.top
rules:
- host: ssl.alb.ingress.top
http:
paths:
- backend:
service:
name: demo-service-ssl
port:
number: 80
path: /
pathType: Prefix
Kubernetes'in 1,19'dan eski sürümlerini çalıştıran kümeler
apiVersion: v1
kind: Service
metadata:
name: demo-service-ssl
namespace: default
spec:
ports:
- name: port1
port: 80
protocol: TCP
targetPort: 8080
selector:
app: demo-ssl
sessionAffinity: None
type: ClusterIP
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: demo-ssl
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: demo-ssl
template:
metadata:
labels:
app: demo-ssl
spec:
containers:
- image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
imagePullPolicy: IfNotPresent
name: demo-ssl
ports:
- containerPort: 8080
protocol: TCP
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
annotations:
alb.ingress.kubernetes.io/ssl-redirect: "true"
name: demo-ssl
namespace: default
spec:
ingressClassName: alb
tls:
- hosts:
- ssl.alb.ingress.top
rules:
- host: ssl.alb.ingress.top
http:
paths:
- backend:
serviceName: demo-service-ssl
servicePort: 80
path: /
pathType: Prefix
Sağlık kontrollerini yapılandırın
Arka uç sunucu grubu için sağlık kontrollerini aşağıdaki açıklamalarla yapılandırın.
Arka uç protokolleri olarak HTTPS ve gRPC kullanın
Arka uç protokolü olarak HTTPS veya gRPC kullanmak için alb.ingress.kubernetes.io/backend-protocol açıklamasını ekleyin.
Ingress oluşturulduktan sonra arka uç protokolü değiştirilemez. Protokolleri değiştirmek için Ingress'i silin ve yeni bir tane oluşturun.
Ingress üzerinden gRPC trafiğini iletirken, etki alanı adı için bir TLS sertifikası yapılandırın ve iletişim için TLS kullanın.
| Açıklama | Değerler | Açıklama |
|---|---|---|
alb.ingress.kubernetes.io/backend-protocol |
https |
Arka uç Hizmeti HTTPS kullanır |
grpc |
Arka uç Hizmeti gRPC kullanır. Etki alanı adı üzerinde TLS yapılandırması gerektirir |
Düzenli ifadeleri yapılandırın
Yol kurallarında düzenli ifade eşleştirmesini etkinleştirmek için alb.ingress.kubernetes.io/use-regex: "true" açıklamasını kullanın. Bu açıklama yalnızca pathType: Prefix olan yol kuralları için geçerlidir.
| Açıklama | Açıklama |
|---|---|
alb.ingress.kubernetes.io/use-regex: "true" |
Yol kurallarında düzenli ifadeleri etkinleştirir |
alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME> |
Özel iletim koşullarını yapılandırır. <YOUR-SVC-NAME> ifadesini gerçek Hizmet adıyla değiştirin; bu ad backend.service.name ile eşleşmelidir |
Düzenli ifade eşleştirme kuralları:
| Hedef | Ön ek | Kural örneği | İstemci yolu | Eşleşti mi? | Notlar |
|---|---|---|---|---|---|
| Etki alanı adı | ~ ile başlar |
~test.example.com |
test.EXAMPLE.com |
Evet | Etki alanı adları büyük/küçük harfe duyarsız eşleştirmeyi destekler |
| Yol | ~ ile başlar |
~/api |
/API |
Evet | Büyük/küçük harfe duyarsız eşleştirme |
| Yol | ~* ile başlar |
~*/api |
/Api |
Hayır | Büyük/küçük harfe duyarlı eşleştirme |
Yeniden yazmaları yapılandırın
ALB Ingress, istekleri iletmeden önce istek yolunu yeniden yazar. İki açıklama yeniden yazma davranışını kontrol eder:
alb.ingress.kubernetes.io/rewrite-target: /<path>/${number}— yeniden yazmayı etkinleştirir ve hedef yolu ayarlar. Orijinal yoldan bir yakalama grubuna referans vermek için${number}biçimini kullanın (en fazla üç grup:${1},${2},${3}).pathTypedeğeriPrefixolmalıdır.alb.ingress.kubernetes.io/use-regex— yolda düzenli ifadelerin kullanılıp kullanılmayacağını belirtir.rewrite-targetyapılandırıldığında otomatik olarak etkinleştirilir. Devre dışı bırakmak için"false"olarak ayarlayın; regex devre dışı bırakıldığında özel karakterler içeren yolların (%#;!()[]^,"\") oluşturulamayacağını unutmayın.
Senaryo 1: Bir öneki kaldırın
path: /something(/|$)(.*) yolu üç yakalama grubu kullanır:
/something— kaldırılacak ön eki eşleştirir(/|$)— ilk grup:/veya yol sonunu eşleştirir(.*)— ikinci grup:/something/sonrası her şeyi yakalar ve yeniden yazma hedefinde${2}olarak referans verilir
Yeniden yazma hedefi / + ${2}, /something ön ekini kaldırır:
| Orijinal yol | Eşleşti mi? | Yeniden yazılan yol |
|---|---|---|
/something |
Evet (ikinci grup boştur) | / |
/something/ |
Evet (ikinci grup boştur) | / |
/something/new |
Evet (ikinci grup: new) |
/new |
/something-new/item |
Hayır | 503 |
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true"
alb.ingress.kubernetes.io/rewrite-target: /${2}
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /something(/|$)(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
Senaryo 2: Birden çok bölümü yakalayın ve yeniden düzenleyin
/items/(.*)/(.*)/(.*) yolu üç segmenti yakalar. Yeniden yazma hedefi /${2}?code=${3} URL'yi ikinci ve üçüncü grupları kullanarak yeniden yapılandırır.
Bu desen tam olarak dört yol segmenti gerektirir. İstemciler sabit bir yol biçimi kullanmalıdır.
| Orijinal yol | Eşleşti mi? | Yeniden yazılan yol |
|---|---|---|
/items/electronics/computers/554 |
Evet (grup 2: computers, grup 3: 554) |
/computers?code=554 |
/items/produce/fruits/12 |
Evet (grup 2: fruits, grup 3: 12) |
/fruits?code=12 |
/items/headphones/5 |
Hayır | 503 |
/drinks/41 |
Hayır | 503 |
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true"
alb.ingress.kubernetes.io/rewrite-target: /${2}?code=${3}
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /items/(.*)/(.*)/(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
Senaryo 3: Birden çok yolu tek bir yola yeniden yazın
Aşağıdaki örnek, aynı yeniden yazma hedefi /${2} → /app-c/${2} ile iki yol kuralı tanımlayarak hem /app-a hem de /app-b yollarını /app-c yoluna yönlendirir.
| Orijinal yol | Eşleşti mi? | Yeniden yazılan yol |
|---|---|---|
/app-a/item1 |
Evet (grup 2: item1) |
/app-c/item1 |
/app-a/item2 |
Evet (grup 2: item2) |
/app-c/item2 |
/app-a veya /app-a/ |
Evet (grup 2 boştur) | /app-c/ |
/drinks/41 |
Hayır | 503 |
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true"
alb.ingress.kubernetes.io/rewrite-target: /app-c/${2}
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /app-a(/|$)(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
- path: /app-b(/|$)(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
Senaryo 4: Bir etki alanı adını yeniden yazın
rewrite-target açıklaması yalnızca yolu değiştirir. Etki alanı adı veya sorgu parametreleri gibi URL'nin diğer bölümlerini yeniden yazmak için özel iletim kurallarını kullanın.
Yeniden yazma kurallarını yerel olarak doğrulayın
Dağıtmadan önce yol regex eşleşmelerini test etmek ve yeniden yazılan sonuçları önizlemek için sed kullanın.
Aşağıdaki örnek, Senaryo 2 içindeki /items/(.*)/(.*)/(.*) yol regex'ini ve /${2}?code=${3} yeniden yazma kuralını test eder.
-
Test yollarını
path2.txtdosyasına kaydedin:/items/electronics/computers/554 /items/produce/fruits/12 /items/headphones/5 /drinks/41 -
sedile yeniden yazmayı simüle edin. Yol regex'inde/karakterini\/olarak kaçış karakteriyle yazın ve yakalama grupları için${2}yerine\2kullanın:sed -E 's#\/items\/(.*)\/(.*)\/(.*)#Matched: [&] ---> Rewritten: [/\2?code=\3]#' path2.txtBeklenen çıktı — ilk iki yol yeniden yazma kuralıyla eşleşir; son ikisi eşleşmez:
Matched: [/items/electronics/computers/554] ---> Rewritten: [/computers?code=554] Matched: [/items/produce/fruits/12] ---> Rewritten: [/fruits?code=12] /items/headphones/5 /drinks/41
Özel dinleyici bağlantı noktalarını yapılandırın
Bir Hizmeti HTTP 80 ve HTTPS 443 gibi birden çok bağlantı noktasında göstermek için alb.ingress.kubernetes.io/listen-ports açıklamasını kullanın.
ALB, Ingress'ten dinleyiciler oluşturmaz. Önce AlbConfig içinde gerekli dinleyici bağlantı noktalarını ve protokollerini oluşturun, ardından bunları Ingress ile ilişkilendirin.
| Açıklama | Açıklama |
|---|---|
alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]' |
Hizmetin hem 80 hem de 443 bağlantı noktasını dinlemesini yapılandırır |
İletim kuralı önceliğini yapılandırın
Varsayılan olarak, ALB iletim kurallarını aşağıdaki sıraya göre sıralar:
Ingress'ler arasında:
namespace/nameleksikografik olarak sıralanır. Daha küçük değerler daha yüksek önceliğe sahiptir. Önce ad alanı, sonra ad karşılaştırılır.-
Aynı Ingress içinde:
rulesalanındaki sıraya göre sıralanır. Daha önce listelenen kurallar daha yüksek önceliğe sahiptir.rules: - host: www.example.com # Higher priority http: ... - host: www.test.com # Lower priority http: ...
Ingress'i yeniden adlandırmadan varsayılan sıralama düzenini geçersiz kılmak için alb.ingress.kubernetes.io/order açıklamasını kullanın.
Aynı dinleyici içindeki öncelikler benzersiz olmalıdır.
| Açıklama | Aralık | Varsayılan | Açıklama |
|---|---|---|---|
alb.ingress.kubernetes.io/order |
[1, 1000] | 10 | İletim kuralı önceliği. Daha düşük değerler daha yüksek önceliğe sahiptir |
Açıklamalar kullanarak kademeli sürüm yayınlama uygulayın
ALB, istek üstbilgilerine, çerezlere ve trafik ağırlıklarına dayalı kademeli sürüm yayınlamayı destekler. Üretim Ingress'inin yanına ayrı bir kademeli Ingress oluşturun.
Canary routing priority: Üstbilgi > Çerez > Ağırlık (yüksekten düşüğe).
Kademeli sürüm yayınlama sırasında üretim Ingress'ini silmeyin. Kademeli sürüm yayınlama doğrulandıktan sonra, üretim Ingress'indeki arka uç Hizmetini yeni sürüme yönlendirecek şekilde güncelleyin ve ardından kademeli Ingress'i silin.
Bkz. ALB Ingress aracılığıyla aşamalı yayınlamaları uygulayın.
Üstbilgiye göre yönlendirin
Belirli bir üstbilgi değeriyle eşleşen istekleri kademeli Hizmete yönlendirmek için canary-by-header ve canary-by-header-value birlikte kullanın. Eşleşmeyen istekler bir sonraki kademeli kurala (çerez veya ağırlık) düşer.
Bu yapılandırmayla, location: hz içeren istekler kademeli Hizmete yönlendirilir. Diğer tüm istekler bir sonraki kademeli kurala düşer.
| Açıklama | Açıklama |
|---|---|
alb.ingress.kubernetes.io/canary-by-header |
Eşleştirilecek istek üstbilgisi adı |
alb.ingress.kubernetes.io/canary-by-header-value |
Eşleştirilecek tam üstbilgi değeri. Her iki açıklama da birlikte yapılandırılmalıdır |
Çereze göre yönlendirin
İstekleri bir çerez adına göre yönlendirmek için canary-by-cookie kullanın. Çerez değerini her zaman kademeli Hizmete yönlendirmek için always veya hariç tutmak için never olarak ayarlayın.
Bu yapılandırmayla, Cookie: demo=always içeren istekler kademeli Hizmete yönlendirilir. Cookie: demo=never içeren istekler kademeli Hizmeti tamamen atlar.
| Açıklama | Değerler | Açıklama |
|---|---|---|
alb.ingress.kubernetes.io/canary-by-cookie |
always |
Tüm istekler kademeli Hizmete yönlendirilir |
never |
Hiçbir istek kademeli Hizmete yönlendirilmez |
Çerez tabanlı kademeli yönlendirme yalnızca always ve never değerlerini destekler. Özel çerez değerleri desteklenmez.
Ağırlığa göre yönlendirin
Trafiğin bir yüzdesini kademeli Hizmete göndermek için canary-weight kullanın. Aşağıdaki örnek, trafiğin %50'sini kademeli sürüme yönlendirir:
| Açıklama | Aralık | Açıklama |
|---|---|---|
alb.ingress.kubernetes.io/canary-weight |
0–100 | Kademeli Hizmete yönlendirilen isteklerin yüzdesi |
Açıklamalar kullanarak oturum kalıcılığı uygulayın
ALB Ingress, çerez tabanlı oturum kalıcılığını destekler. Etkinleştirmek ve yapılandırmak için aşağıdaki açıklamaları ekleyin.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: cafe-ingress-v3
annotations:
alb.ingress.kubernetes.io/sticky-session: "true"
alb.ingress.kubernetes.io/sticky-session-type: "Insert" # Use "Server" for custom cookies
alb.ingress.kubernetes.io/cookie-timeout: "1800"
alb.ingress.kubernetes.io/cookie: "test"
spec:
...
| Açıklama | Açıklama | Varsayılan |
|---|---|---|
alb.ingress.kubernetes.io/sticky-session |
Oturum kalıcılığını etkinleştirin: true veya false |
false |
alb.ingress.kubernetes.io/sticky-session-type |
Çerez işleme modu. Insert: ALB, sonraki istekleri aynı arka uca yönlendirmek için bir SERVERID çerezi ekler. Server: ALB, yönlendirme için özel bir çerezi yeniden yazar. Sunucu grubunda StickySessionEnabled değerinin true olarak ayarlanmasını gerektirir. Bkz. Sunucu grubu oluşturma |
Insert |
alb.ingress.kubernetes.io/cookie-timeout |
Saniye cinsinden çerez zaman aşımı. Aralık: [1, 86400]. sticky-session-type değeri Insert olduğunda geçerlidir |
1000 |
alb.ingress.kubernetes.io/cookie |
Özel çerez adı. sticky-session-type değeri Server olduğunda gereklidir ve boş bırakılamaz |
"" |
Bir yük dengeleme algoritması belirtin
Bir arka uç sunucu grubu için yük dengeleme algoritmasını ayarlamak üzere alb.ingress.kubernetes.io/backend-scheduler açıklamasını kullanın.
| Değer | Algoritma | Açıklama |
|---|---|---|
wrr |
Ağırlıklı döngüsel sıralama | Daha yüksek ağırlığa sahip arka uç sunucuları daha fazla istek alır. Varsayılan algoritma |
wlc |
Ağırlıklı en az bağlantı | Sunucu ağırlığına göre ağırlıklandırılmış, en az aktif bağlantısı olan sunucuya yönlendirir |
sch |
Kaynak IP tutarlı karma | Aynı istemci IP'sinden gelen istekleri aynı arka uç sunucusuna yönlendirir |
uch |
URL parametresi tutarlı karma | URL parametresi karmasına göre yönlendirir. Parametre adını alb.ingress.kubernetes.io/backend-scheduler-uch-value ile ayarlayın |
Kaynaklar arası kaynak paylaşımını yapılandırın
Tarayıcıların Hizmete çapraz kaynak istekleri yapmasına izin vermek için CORS açıklamaları ekleyin.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: alb-ingress
annotations:
alb.ingress.kubernetes.io/enable-cors: "true"
alb.ingress.kubernetes.io/cors-expose-headers: ""
alb.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
alb.ingress.kubernetes.io/cors-allow-credentials: "true"
alb.ingress.kubernetes.io/cors-max-age: "600"
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: cloud-nodeport
port:
number: 80
| Açıklama | Açıklama | Varsayılan |
|---|---|---|
alb.ingress.kubernetes.io/cors-allow-origin |
İzin verilen kaynaklar. http:// veya https:// ile başlamalı, ardından geçerli bir etki alanı veya üst düzey joker karakterli etki alanı gelmelidir. Birden çok kaynağı virgülle ayırın. Örnek: "https://example.com:4443, http://aliyundoc.com, https://example.org:1199" |
* |
alb.ingress.kubernetes.io/cors-allow-methods |
İzin verilen çapraz kaynak yöntemleri. Büyük/küçük harfe duyarsız. Birden çok yöntemi virgülle ayırın. Örnek: "PUT, GET, POST, OPTIONS" |
GET, PUT, POST, DELETE, PATCH, OPTIONS |
alb.ingress.kubernetes.io/cors-allow-headers |
İzin verilen istek üstbilgileri. Üstbilgiler harf, rakam, alt çizgi (_) ve kısa çizgi (-) içerebilir. Birden çok üstbilgiyi virgülle ayırın. Örnek: "X-Forwarded-For, X-app123-XPTO" |
DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization |
alb.ingress.kubernetes.io/cors-expose-headers |
Tarayıcıya gösterilen üstbilgiler. Harf, rakam, alt çizgi (_), kısa çizgi (-) ve yıldız işareti (*) içerebilir. Birden çok üstbilgiyi virgülle ayırın. Örnek: "*, X-CustomResponseHeader" |
Boş |
alb.ingress.kubernetes.io/cors-allow-credentials |
Çapraz kaynak isteklerinde kimlik bilgilerine izin verilip verilmeyeceği. Örnek: "false" |
true |
alb.ingress.kubernetes.io/cors-max-age |
OPTIONS ön talep yanıtları için maksimum önbellekleme süresi saniye cinsinden. Aralık: [−1, 172800] | 172800 |
Kalıcı arka uç bağlantılarını etkinleştirin
Kalıcı arka uç bağlantıları, arka uç sunucularıyla olan TCP bağlantılarını yeniden kullanarak istek başına bağlantı açma ve kapatma ek yükünü azaltır.
Bu özelliği etkinleştirmek için alb.ingress.kubernetes.io/backend-keepalive: "true" açıklamasını ekleyin:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: alb-ingress
annotations:
alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: cloud-nodeport
port:
number: 80
QPS hız sınırlarını ayarlayın
İletim kuralı düzeyinde QPS kısıtlaması ayarlamak için alb.ingress.kubernetes.io/traffic-limit-qps açıklamasını ekleyin:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: cafe-ingress
annotations:
alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /tea
pathType: ImplementationSpecific
backend:
service:
name: tea-svc
port:
number: 80
- path: /coffee
pathType: ImplementationSpecific
backend:
service:
name: coffee-svc
port:
number: 80
| Açıklama | Aralık | Açıklama |
|---|---|---|
alb.ingress.kubernetes.io/traffic-limit-qps |
[1, 100.000] | İletim kuralı için maksimum QPS |
Yeni pod'lar için yavaş başlatmayı yapılandırın
Yavaş başlatma, yapılandırılan süre boyunca yeni pod'lara giden trafiği kademeli olarak artırarak soğuk bir poda tam trafikin binmesinden kaynaklanan geçici CPU veya bellek artışlarını önler.
| Açıklama | Açıklama | Varsayılan |
|---|---|---|
alb.ingress.kubernetes.io/slow-start-enabled |
Yavaş başlatmayı etkinleştirin: true veya false |
false |
alb.ingress.kubernetes.io/slow-start-duration |
Saniye cinsinden artış süresi. Daha uzun süreler trafik artışını yavaşlatır. Aralık: [30, 900] | 30 |
Bağlantı boşaltmayı yapılandırın
Bir pod Terminating durumuna geçtiğinde, ALB onu arka uç sunucu grubundan kaldırır. Bağlantı boşaltma olmadan, mevcut bağlantılardaki devam eden istekler başarısız olabilir.
Bağlantı boşaltma, aktif bağlantıları yapılandırılan bir süre boyunca açık tutarak pod çevrimdışı duruma geçmeden önce devam eden isteklerin tamamlanmasına olanak tanır.
Boşaltma zaman aşımı bitmeden önce, ALB pod'un sağlıklı kalacağını garanti edemez. Terminating durumu sırasında pod kullanılabilirliğini kontrol etmek için pod üzerinde spec.terminationGracePeriodSeconds yapılandırın veya preStop hook kullanın.
Bkz. ALB bağlantı boşaltma yoluyla sorunsuz iş çevrimdışı olma sağlayın.
| Açıklama | Açıklama | Varsayılan |
|---|---|---|
alb.ingress.kubernetes.io/connection-drain-enabled |
Bağlantı boşaltmayı etkinleştirin: true veya false |
false |
alb.ingress.kubernetes.io/connection-drain-timeout |
Bir pod kaldırıldıktan veya sağlık kontrolünden başarısız olduktan sonra ALB'nin bağlantıları kapatmadan önce beklediği maksimum süre saniye cinsinden. Aralık: [0, 900] | 300 |