Yönlendirme kuralları, HTTPS yönlendirmeleri, yeniden yazma işlemleri, kanarya sürümleri ve oturum kalıcılığı gibi gelişmiş ALB Ingress özelliklerini yapılandırın.
İstekleri alan adlarına göre iletme
İstekleri bir alan adına veya boş bir alan adına göre iletmek için bir Ingress kaynağı oluşturun.
Alan adı
Bu örnekte yönlendirme yolu /hello olarak ayarlanır. demo.domain.ingress.top/hello adresine yapılan istekler arka uç hizmetine iletilir.
-
Belirtilen alan adına göre istekleri ileten bir Service, bir Deployment ve bir Ingress kaynağı oluşturmak için aşağıdaki bildirimi dağıtın.
-
ALB örneğinin adresini almak için
kubectl get ingkomutunu çalıştırın. Ardından,ADDRESSifadesini örneğin adresiyle değiştirerek aşağıdaki komutu çalıştırın.curl -H "host: demo.domain.ingress.top" ADDRESS/helloBeklenen çıktı:
{"hello":"coffee"}
Boş alan adı
Boş bir alan adı ve /hello yönlendirme yolu kullanıldığında, ADDRESS/hello adresine yapılan istekler arka uç hizmetine iletilir.
-
Bir Service, bir Deployment ve bir Ingress kaynağı oluşturmak için aşağıdaki bildirimi dağıtın.
-
ALB örneğinin adresini almak için
kubectl get ingkomutunu çalıştırın. Ardından,ADDRESSifadesini örneğin adresiyle değiştirerek aşağıdaki komutu çalıştırın.curl ADDRESS/helloBeklenen çıktı:
{"hello":"coffee"}
Yola dayalı yönlendirme
ALB Ingress, istekleri URL yollarına göre iletir. Eşleşme modunu pathType alanında belirtin. pathType üç modu destekler.
Tam eşleşme (Exact): URL yolunu tam olarak eşleştirir.
Varsayılan (ImplementationSpecific): ALB Ingress Denetleyicisi bunu tam eşleşme olarak değerlendirir. Yol belirtilmezse varsayılan değer
/olur.Önek eşleşmesi (Prefix): URL yolunun önekiyle eşleşir.
pathTypedeğeriExactveyaPrefixolduğunda, yol boş olmayan mutlak bir yol olmalıdır. Aksi takdirde doğrulama başarısız olur.URL eşleşme ilkeleri çakışırsa istekler yönlendirme kuralı önceliğine göre iletilir.
-
Basit yollar (/, /foo, /foo/)
Eşleşme modu
Kural yolu
İstek yolu
Eşleşti mi?
Önek eşleşmesi (Prefix)
/
/ (tüm yollarla eşleşir)
Evet
/foo
-
/foo
-
/foo/
Evet
/foo/
-
/foo
-
/foo/
Evet
/aaa
/ccc
Hayır. Önek eşleşmiyor.
Tam eşleşme (Exact) veya varsayılan (ImplementationSpecific)
/foo
/foo
Evet
/bar
Hayır
/foo/
Hayır
/foo/
/foo
Hayır
-
-
Hiyerarşik yollar (/aaa/bb, /aaa/bbb, /aaa/bbb/)
Eşleşme modu
Kural yolu
İstek yolu
Eşleşti mi?
Önek eşleşmesi (Prefix)
/aaa/bb
/aaa/bbb
Hayır
/aaa/bbb
/aaa/bbb
Evet
/aaa/bbb/
/aaa/bbb
Evet. Kural yolundaki sondaki eğik çizgi yok sayılır.
/aaa/bbb
/aaa/bbb/
Evet. İstek yolundaki sondaki eğik çizgi eşleşir.
/aaa/bbb/ccc
Evet. Kural yolu, istek yolunun önekidir.
-
İki kural yolu
Eşleşme modu
Kural yolu
İstek yolu
Eşleşti mi?
Önek eşleşmesi (Prefix)
-
/
-
/aaa
/aaa/ccc
Evet. İstek yolu
/aaakural yoluyla eşleşir.-
/aaa
-
/
/aaa/ccc
Evet. İstek yolu
/aaakural yoluyla eşleşir./ccc
Evet. İstek yolu
/kural yoluyla eşleşir.-
/aaa
-
/bbb
/ccc
Hayır. Önek eşleşmiyor.
-
Her eşleşme modu için örnekler:
Önek eşleşmesi (Prefix)
Bu mod, / karakteriyle ayrılan URL yolu öğeleri üzerinde büyük/küçük harfe duyarlı bir önek eşleşmesi gerçekleştirir.
/ kural yolu, / ile başlayan /hello gibi tüm yollarla eşleşir.
-
Ingress kaynağını oluşturmak için aşağıdaki bildirimi dağıtın.
-
ALB örneğinin adresini almak için
kubectl get ingkomutunu çalıştırın. Ardından,ADDRESSifadesini alınan adresle değiştirerek aşağıdaki komutu çalıştırın.curl ADDRESS/helloBeklenen çıktı:
{"hello":"coffee"}
Tam eşleşme veya varsayılan
/hello kural yolu yalnızca /hello adresine yapılan isteklerle eşleşir.
-
Ingress kaynağını oluşturmak için aşağıdaki bildirimi dağıtın.
-
ALB örneğinin adresini almak için
kubectl get ingkomutunu çalıştırın. Ardından,ADDRESSifadesini alınan adresle değiştirerek aşağıdaki komutu çalıştırın.curl ADDRESS/helloBeklenen çıktı:
{"hello":"coffee"}
Sağlık kontrollerini yapılandırma
ALB Ingress için sağlık kontrollerini yapılandırmak amacıyla ek açıklamaları (annotations) kullanın.
Örnek ek açıklamalar:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: cafe-ingress
annotations:
alb.ingress.kubernetes.io/healthcheck-enabled: "true"
alb.ingress.kubernetes.io/healthcheck-path: "/"
alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
alb.ingress.kubernetes.io/healthcheck-httpversion: "HTTP1.1"
alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
alb.ingress.kubernetes.io/healthcheck-code: "http_2xx"
alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
alb.ingress.kubernetes.io/healthy-threshold-count: "3"
alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
spec:
... ...
|
Parametre |
Açıklama |
Varsayılan |
|
|
Arka uç sunucu grubu için sağlık kontrollerinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
|
|
|
|
Sağlık kontrolleri için kullanılan yol. |
|
|
|
Sağlık kontrolleri için kullanılan protokol.
|
|
|
|
HTTP protokolü sürümü. Yalnızca
|
|
|
|
Sağlık kontrolleri için kullanılan yöntem.
Önemli
|
|
|
|
Arka uç sunucusunun sağlıklı olduğunu belirten durum kodu(kodları). Virgülle ayrılmış bir veya daha fazla seçenek belirtin.
|
|
|
|
Arka uç sunucusunun sağlıklı olduğunu belirten durum kodu(kodları). Her iki parametre de belirtilirse Geçerli değerler
|
|
|
|
Saniye cinsinden sağlık kontrolü zaman aşımı süresi. Geçerli değerler: 1 ila 300. |
|
|
|
Saniye cinsinden sağlık kontrolü aralığı. Geçerli değerler: 1 ila 50. |
|
|
|
Bir arka uç sunucusunu sağlıklı olarak işaretlemek için gereken ardışık başarılı sağlık kontrolü sayısı. Geçerli değerler: 2 ila 10. |
|
|
|
Bir arka uç sunucusunu sağlıksız olarak işaretlemek için gereken ardışık başarısız sağlık kontrolü sayısı. Geçerli değerler: 2 ila 10. |
|
|
|
Sağlık kontrolleri için kullanılan bağlantı noktası. |
Not
|
HTTP isteklerini HTTPS'ye yönlendirme
HTTP isteklerini 443 numaralı HTTPS bağlantı noktasına yönlendirmek için aşağıdaki ek açıklamayı ekleyin.
Bu özellik yalnızca 80 numaralı dinleyici bağlantı noktasındaki HTTP yönlendirme kuralları için geçerlidir.
Bu ek açıklama,
RemoveHeader,InsertHeaderveCorsgibi özel yönlendirme eylemlerine yönelik ek açıklamalarla birlikte kullanılmalıdır.Bu ek açıklamayı kullanmadan önce AlbConfig içinde 443 numaralı bağlantı noktasında bir HTTPS dinleyicisinin yapılandırıldığından emin olun. Bkz. AlbConfig kullanarak bir ALB dinleyicisi yapılandırma.
|
Parametre |
Açıklama |
Ek açıklama örneği |
|
|
HTTP isteklerini 443 numaralı HTTPS bağlantı noktasına yönlendirir. |
|
Arka uç HTTPS veya gRPC yapılandırma
Arka uç protokolü olarak HTTPS veya gRPC kullanmak için aşağıdaki açıklamayı ekleyin.
Ingress oluşturulduktan sonra arka uç protokolü değiştirilemez. Protokolü değiştirmek için Ingress'i silip yeniden oluşturun.
|
Parametre |
Açıklama |
YAML örneği |
|
|
|
|
Düzenli ifadeleri yapılandırma
spec.rules içindeki yol kuralları için düzenli ifade eşleştirmesini etkinleştirmek amacıyla alb.ingress.kubernetes.io/use-regex: "true" açıklamasını ve pathType: Prefix değerini kullanın.
Yalnızca
pathType: Prefixiçeren yol kuralları için geçerlidir. Özel yönlendirme koşullarından bağımsız olarak,spec.rulesiçindekipathalanında düzenli ifade sözdizimini etkinleştirir.Bu açıklama, değerinden bağımsız olarak (
trueveyafalse) düzenli ifade eşleştirmesini etkinleştirir. Eşleştirmeyi devre dışı bırakmak için açıklamayı kaldırın.Bu açıklama olmadan, yol
=^()[]|gibi özel karakterler içeriyorsa Ingress oluşturma işlemi başarısız olur.Özel bir yönlendirme koşulundaki (
alb.ingress.kubernetes.io/conditions.YOUR-SVC-NAME) yol değerleri doğrudan ALB'ye iletilir veuse-regexaçıklaması gerektirmez. Düzenli ifade eşleştirmesini etkinleştirmek için yol değerine~*veya~ön ekini ekleyin.use-regexaçıklaması yalnızcaspec.rulesiçindekipathalanını etkiler.
Özel yönlendirme kuralları
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
alb.ingress.kubernetes.io/conditions.YOUR-SVC-NAME: | ## Replace YOUR-SVC-NAME with the actual Service name. It must match backend.service.name below.
[{
"type": "Path",
"pathConfig": {
"values": [
"~*/pathvalue1", ## Add the ~* or ~ prefix to a regular expression. The text after the prefix is the regular expression itself. ~* indicates a case-sensitive match, and ~ indicates a case-insensitive match.
"/pathvalue2" ## An exact match does not require a prefix.
]
}
}]
name: ingress-example
spec:
ingressClassName: alb
rules:
- http:
paths:
- path: /test-path-for-alb
pathType: Prefix
backend:
service:
name: YOUR-SVC-NAME ## YOUR-SVC-NAME here must match the Service name specified in the custom forwarding condition annotation to define the association.
port:
number: 88
Spec.rules
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
alb.ingress.kubernetes.io/use-regex: "true" ## Allows the path in spec.rules to use a regular expression.
name: ingress-example
spec:
ingressClassName: alb
rules:
- http:
paths:
- path: /test-[a-z]-alb[()^]*
pathType: Prefix
backend:
service:
name: tea-svc
port:
number: 88
|
Parametre |
Açıklama |
|
|
|
|
|
|
|
Özel bir yönlendirme koşulu yapılandırır. Ayrıntılar için bkz. ALB Ingress için yönlendirme kurallarını özelleştirme.
|
|
Aşağıdaki tabloda düzenli ifade eşleştirme kuralları açıklanmaktadır.
|
Nesne |
Ön Ek |
Kural örneği |
İstemci yolu |
Eşleşiyor mu? |
Açıklama |
|
Alan adı |
|
|
test.EXAMPLE.com |
Evet |
Alan adları, büyük/küçük harfe duyarsız düzenli ifade eşleştirmesini destekler. |
|
Yol |
|
|
/API |
Evet |
Yollar, büyük/küçük harfe duyarsız düzenli ifade eşleştirmesini destekler. |
|
|
|
/Api |
Hayır |
Yollar, büyük/küçük harfe duyarlı düzenli ifade eşleştirmesini destekler. |
Düzenli ifade ön ek eşleştirmesi
Düzenli ifade eşleştirmesi varsayılan olarak 'içerir' eşleşmesi yapar. Yalnızca belirli içerikle başlayan yolları eşleştirmek için ifadenin başına ^ ekleyin. Örneğin, ^/api yalnızca /api ile başlayan yolları eşleştirir.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: ingress-example
annotations:
alb.ingress.kubernetes.io/use-regex: "true" ## Enable regex matching.
alb.ingress.kubernetes.io/conditions.YOUR-SVC-NAME: | ## Replace YOUR-SVC-NAME with the actual service name. This must match backend.service.name below.
[
{
"type": "Path",
"pathConfig": {
"values": [
"~*^/pathvalue1", # A path that starts with ~* or ~ indicates a regex match. The caret (^) indicates "starts with /pathvalue1".
"/pathvalue2" # For a standard prefix or exact match, do not add ~* or ~.
]
}
}
]
spec:
ingressClassName: alb
rules:
- http:
paths:
- path: /test-path-for-alb
pathType: Prefix
backend:
service:
name: YOUR-SVC-NAME # Replace with the actual service name, which must match the annotation.
port:
number: 88
Yeniden yazmaları yapılandırma
ALB Ingress, istekleri arka uç Hizmetine iletmeden önce istek yollarını yeniden yazar. Aşağıdaki iki açıklamayı kullanın:
-
alb.ingress.kubernetes.io/rewrite-target: /path/${number}: İsteklerin yeniden yazılacağı yolu belirtir.ÖnemliIngress yolundaki düzenli ifadeden yakalama gruplarına başvurmak için
${number}değişkenlerini kullanın. En fazla üç yakalama grubuna${1},${2}ve${3}kullanılarak başvurulabilir.Ingress'in
pathTypedeğeriPrefixolarak ayarlanmalıdır.
-
alb.ingress.kubernetes.io/use-regex: true: Yol içinde düzenli ifade kullanımını etkinleştirir.rewrite-targetyapılandırdığınızda bu özellik varsayılan olarak etkinleştirilir.ÖnemliBu açıklama, değerinden bağımsız olarak (
trueveyafalse) düzenli ifade eşleştirmesini etkinleştirir. Eşleştirmeyi devre dışı bırakmak için açıklamayı kaldırın.Bu açıklama olmadan, yol
"%#;!()[]^,"\""gibi özel karakterler içeriyorsa Ingress oluşturma işlemi başarısız olur.
Yapılandırma örnekleri
Örnek 1: Ön eki kaldırma
Aşağıdaki YAML örneğinde, path: /something(/|$)(.*) düzenli ifadesi istemci isteği yolunu üç parçaya böler:
/something: Kaldırılacak ön ekle eşleşir.(/|$): İlk yakalama grubudur;/somethingöğesinden sonraki bir/karakteriyle veya yolun sonuyla ($) eşleşir.(.*): İkinci yakalama grubudur;/something/öğesinden sonraki tüm karakterlerle eşleşir ve yeniden yazılan yolda${2}olarak referans verilir.
alb.ingress.kubernetes.io/rewrite-target açıklaması, yeniden yazılan yolu / ve ardından ${2} olarak belirtir. Aşağıdaki tabloda yeniden yazma sonuçları gösterilmektedir.
|
Orijinal istemci yolu |
Yol düzenli ifade eşleşmesi |
Yeniden yazılan yol |
|
|
Eşleşiyor. İkinci yakalama grubu boş. |
|
|
|
Eşleşiyor. İkinci yakalama grubu boş. |
|
|
|
Eşleşiyor. İkinci yakalama grubu |
|
|
|
Eşleşmiyor. Bu örnekte, istek herhangi bir yönlendirme kuralıyla eşleşmediği için ALB Ingress 503 durum kodu döndürür. |
|
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true" # Allows the path field to use a regular expression.
alb.ingress.kubernetes.io/rewrite-target: /${2} # This annotation supports regular expression replacement.
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /something(/|$)(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
Örnek 2: Birden çok parçayı yakalama ve yeniden düzenleme
Aşağıdaki örnek, /items/(.*)/(.*)/(.*) yolunun birden çok parçasını yakalar ve yeniden düzenler. Ayrıca, istemci tarafında değişiklik gerektirmeden yol segmentlerini sorgu parametrelerine dönüştürür. Yeniden yazılan yol, /, ikinci yakalama grubu ${2}, ?code= dizesi ve üçüncü yakalama grubu ${3} kullanılarak oluşturulur. Aşağıdaki tabloda yeniden yazma sonuçları gösterilmektedir.
Bu örnek, istemcinin dört segmentli sabit bir yol biçimi kullanmasını gerektirir.
|
Orijinal istemci yolu |
Yol düzenli ifade eşleşmesi |
Yeniden yazılan yol |
|
|
Eşleşiyor. İkinci yakalama grubu |
|
|
|
Eşleşiyor. İkinci yakalama grubu |
|
|
|
Eşleşmiyor. Bu örnekte, istek herhangi bir yönlendirme kuralıyla eşleşmediği için ALB Ingress 503 durum kodu döndürür. |
|
|
|
Eşleşmiyor. Bu örnekte, istek herhangi bir yönlendirme kuralıyla eşleşmediği için ALB Ingress 503 durum kodu döndürür. |
|
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true" # Allows the path field to use a regular expression.
alb.ingress.kubernetes.io/rewrite-target: /${2}?code=${3} # This annotation supports regular expression replacement.
spec:
ingressClassName: alb
rules:
- host: demo.alb.ingress.top
http:
paths:
- path: /items/(.*)/(.*)/(.*)
pathType: Prefix
backend:
service:
name: rewrite-svc
port:
number: 9080
Örnek 3: Birden çok yolu tek bir yola yeniden yazma
Aşağıdaki örnek, birden çok yolu (/app-a(/|$)(.*) ve /app-b(/|$)(.*)) eşleştirmek ve bunları tek bir yola yeniden yazmak için düzenli ifade kullanır. Yeniden yazılan yol, /app-c/ ve ardından ${2} şeklindedir. Aşağıdaki tabloda yeniden yazma sonuçları gösterilmektedir.
|
Orijinal istemci yolu |
Yol düzenli ifade eşleşmesi |
Yeniden yazılan yol |
|
|
Eşleşiyor. İkinci yakalama grubu |
|
|
|
Eşleşiyor. İkinci yakalama grubu |
|
|
|
Eşleşiyor. İkinci yakalama grubu boş. |
|
|
|
Eşleşmiyor. Bu örnekte, istek herhangi bir yönlendirme kuralıyla eşleşmediği için ALB Ingress 503 durum kodu döndürür. |
|
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: rewrite-ingress
annotations:
alb.ingress.kubernetes.io/use-regex: "true" # allows the path field to use a regular expression.
alb.ingress.kubernetes.io/rewrite-target: /app-c/${2} # This annotation supports regular expression replacement.
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
Örnek 4: Alan adını yeniden yazma
alb.ingress.kubernetes.io/rewrite-target açıklaması yalnızca yolun değiştirilmesini destekler. URL'nin alan adı veya sorgu parametreleri gibi diğer bölümlerini değiştirmek için bir özel yönlendirme kuralı kullanın.
Yeniden yazma kurallarını test etme
Bir istemci yolunun yolun düzenli ifadesiyle eşleşip eşleşmediğini test etmek ve yeniden yazılan yolu önizlemek için sed komutunu kullanın.
Bu örnekte, Örnek 2: Birden çok parçayı yakalama ve yeniden düzenleme bölümündeki /items/(.*)/(.*)/(.*) yakalama yolu ve /${2}?code=${3} yeniden yazma kuralı kullanılmaktadır.
-
Aşağıdaki örnek yolları
path2.txtadlı bir dosyaya kaydedin:/items/electronics/computers/554 /items/produce/fruits/12 /items/headphones/5 /drinks/41 -
Yolların eşleşip eşleşmediğini kontrol edin ve yeniden yazılan yolları görüntüleyin:
Aşağıdaki komut, örneğin yol düzenli ifadesini (
/items/(.*)/(.*)/(.*)) ve yeniden yazılan yolu (/${2}?code=${3}) sed için adapte eder. Sed kullanırken,/gibi özel karakterler ters eğik çizgi (\) ile kaçış karakteri olarak işaretlenmeli ve yakalama grubu başvuruları${2}yerine\2şeklinde yazılmalıdır.sed -E 's#\/items\/(.*)\/(.*)\/(.*)#Matched: [] --- Rewritten: [/\2?code=\3]#' path2.txtAşağıdaki çıktı beklenir. İlk iki yol kuralıyla eşleşir ve yeniden yazılır, son iki yol ise eşleşmez ve değişmeden kalır.
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ırma
Bir hizmeti hem 80 numaralı bağlantı noktasında (HTTP) hem de 443 numaralı bağlantı noktasında (HTTPS) göstermek için bir açıklama ekleyin.
ALB, Ingress içinde doğrudan dinleyici oluşturmayı desteklemez. Önce gerekli dinleyici bağlantı noktalarını ve protokollerini bir AlbConfig'de oluşturun, ardından bunları Ingress'te referans verin. Ayrıntılar için bkz. ALB dinleyicisini yapılandırmak için AlbConfig kullanma.
|
Parametre |
Açıklama |
YAML örneği |
|
|
Hizmeti 80 ve 443 numaralı bağlantı noktalarında gösterir. |
|
Yönlendirme kuralı önceliğini yapılandırma
Varsayılan olarak ALB, yönlendirme kurallarını aşağıdaki kriterlere göre önceliklendirir:
-
Sistem, Ingress kaynaklarını
namespace/namedeğerine göre leksikografik olarak sıralar. Leksikografik değeri daha küçük olan bir Ingress daha yüksek önceliğe sahiptir.Önce ad alanları, ardından adlar karakter karakter karşılaştırılır.
-
Tek bir Ingress içinde kurallar,
rulesalanındaki sıralarına göre önceliklendirilir. Listedeki ilk kurallar daha yüksek önceliğe sahiptir.rules: - host: www.example.com http: ... - host: www.test.com http: ...
Ingress'in namespace/name değerini değiştirmeden bir ALB yönlendirme kuralının önceliğini belirtmek için aşağıdaki Ingress açıklamasını ekleyin:
|
Parametre |
Açıklama |
Değer |
YAML örneği |
|
|
ALB yönlendirme kuralının önceliğini belirtir. Daha düşük bir değer daha yüksek öncelik anlamına gelir. Her kuralın önceliği aynı dinleyici içinde benzersiz olmalıdır. |
[1, 1000] Varsayılan: 10 |
|
Ek açıklamalarla kademeli dağıtım uygulama
ALB, üstbilgiler, çerezler ve ağırlıklara dayalı kademeli dağıtımları destekler. En iyi uygulamalar için ALB Ingress kullanarak kademeli dağıtım uygulama konusuna bakın.
|
Parametre |
Açıklama |
Açıklama |
|
|
Kademeli dağıtım özelliğini etkinleştirir. |
|
-
Belirtilen bir üstbilgiye göre kademeli trafiği dağıtma
Parametre
Açıklama
YAML örneği
alb.ingress.kubernetes.io/canary-by-headerBu ek açıklamalar, trafik yönlendirmesi için özel bir istek üstbilgisi ve değeri tanımlar. Her iki ek açıklama da gereklidir.
-
Bir istekteki
headerveheader-value, yapılandırılan değerlerle eşleştiğinde, istek trafiği kademeli hizmet uç noktasına yönlendirilir. -
Eşleşmeyen istekler, daha düşük öncelikli kurallara göre değerlendirilir.
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "1" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-header: "location" alb.ingress.kubernetes.io/canary-by-header-value: "hz" name: demo-canary spec: ... ...alb.ingress.kubernetes.io/canary-by-header-valueBir istek
location: hzüstbilgisini içeriyorsa ALB trafiği kademeli Service'e yönlendirir. Diğer istekler, çerez veya ağırlığa dayalı olanlar gibi daha düşük öncelikli kurallara göre değerlendirilir. -
-
Belirtilen bir çereze göre kademeli trafiği dağıtma
Parametre
Çerez değeri
YAML örneği
alb.ingress.kubernetes.io/canary-by-cookie-
always: Tüm istekleri kademeli Service'e yönlendirir. -
never: İstekleri asla kademeli Service'e yönlendirmez.
Çerez tabanlı kademeli dağıtımlar özel değerleri desteklemez; yalnızca
alwaysveneverdeğerlerini kabul eder.apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "2" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-cookie: "demo" name: demo-canary-cookie ... ...Bir istek
Cookie: demo=alwaysüstbilgisini içeriyorsa ALB trafiği kademeli Service'e yönlendirir. ÜstbilgiCookie: demo=neverdeğerini içeriyorsa ALB trafiği kademeli Service'e yönlendirmez. -
-
Trafiği ağırlığa göre dağıtma
Parametre
Açıklama
YAML örneği
alb.ingress.kubernetes.io/canary-weightKademeli Service'e yönlendirilen trafiğin yüzdesi. Geçerli değerler: 0 ila 100.
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "3" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-weight: "50" name: demo-canary-weight
Ek açıklamalarla oturum kalıcılığını yapılandırma
ALB Ingress için oturum kalıcılığını yapılandırmak üzere aşağıdaki ek açıklamaları kullanın.
Örnek ek açıklamalar:
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: "Server" # To use a custom cookie, set this annotation to Server.
alb.ingress.kubernetes.io/cookie-timeout: "1800"
alb.ingress.kubernetes.io/cookie: "test"
spec:
... ...
|
Parametre |
Açıklama |
Varsayılan |
|
|
Oturum kalıcılığının etkinleştirilip etkinleştirilmeyeceğini belirtir.
|
|
|
|
Yük dengeleyicinin çerezi nasıl işlediğini belirtir.
Not
Yalnızca |
|
|
|
Saniye cinsinden çerez zaman aşımı süresi. Geçerli değerler: 1 ila 86400. Yalnızca |
1000 |
|
|
Özel çerezin değeri.
|
"" |
Yük dengeleme algoritmasını belirtme
Arka uç sunucu grubu için yük dengeleme algoritmasını belirtmek üzere bir ek açıklama kullanın.
|
Parametre |
Değer |
Açıklama |
|
|
|
|
Ağırlıklı döngüsel dağıtım. Daha yüksek ağırlığa sahip sunucular daha fazla istek alır. (Varsayılan) |
|
|
|
İstekleri ağırlığa ve mevcut bağlantı sayısına göre dağıtır. Ağırlıklar eşitse en az bağlantısı olan sunucu seçilir. |
||
|
|
Aynı kaynak IP adresinden gelen istekleri aynı arka uç sunucusuna yönlendirir. |
||
|
|
İstekleri belirtilen URL parametresinin karma değerine göre yönlendirir. Hangi URL parametresinin karma hesaplaması için kullanılacağını belirtmek üzere
|
CORS yapılandırması
ALB Ingress için Çapraz Kaynak Paylaşımını (CORS) yapılandırmak üzere aşağıdaki ek açıklamaları kullanın.
Örnek ek açıklamalar:
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"
alb.ingress.kubernetes.io/cors-allow-origin: "Allowed origin domain name"
spec:
... ...
|
Parametre |
Açıklama |
Varsayılan |
|
|
Çapraz Kaynak Paylaşımını (CORS) etkinleştirir. |
Varsayılan değer: |
|
|
Sunucudaki kaynaklara hangi kaynakların erişebileceğini belirtir. Birden çok kaynağı ayırmak için virgül (,) kullanın. Her değer |
|
|
|
Çapraz kaynak istekleri için izin verilen HTTP yöntemlerini belirtir. Değerler büyük/küçük harfe duyarlı değildir. Birden çok HTTP yöntemini ayırmak için virgül (,) kullanın. |
|
|
|
Çapraz kaynak istekleri için izin verilen istek üstbilgilerini belirtir. Bu parametreyi
|
|
|
|
Hangi yanıt üstbilgilerinin istemciye gösterileceğini belirtir. Bu parametreyi
|
|
|
|
Çapraz kaynak isteklerinde kimlik bilgilerinin dahil edilip edilmeyeceğini belirtir. |
|
|
|
Ön uçuş yanıtları için önbellek süresi (saniye cinsinden). Geçerli değerler: 0 ila 172.800. |
Varsayılan değer: |
Arka uç kalıcı bağlantı
Arka uç kalıcı bağlantılar, ALB'nin arka uç sunucularına yönelik TCP bağlantılarını yeniden kullanmasına olanak tanır ve yüksek aktarım hızı senaryolarında bağlantı ek yükünü azaltır.
|
Parametre |
Açıklama |
YAML örneği |
|
|
TCP bağlantı ek yükünü azaltmak için arka uç kalıcı bağlantıları etkinleştirir. |
|
Sunucu grupları için IPv6 arka uç ekleme
IPv6 arka uç ekleme, bir sunucu grubunda hem IPv4 hem de IPv6 Pod'larının bulunmasına olanak tanır ancak çift yığın kümesi gerektirir. Bkz. ACK yönetilen küme oluşturma.
IPv6 arka uç ekleme etkinleştirildiğinde aşağıdaki sınırlamalar geçerlidir:
Bir sunucu grubu için IPv6 arka uç eklemeyi etkinleştirmek amacıyla sunucu grubunun VPC'sinde IPv6 etkinleştirilmelidir.
IPv6 arka uç ekleme, özel iletme eylemi kullanılarak eklenen IP veya Function Compute türündeki sunucu grupları için desteklenmez.
Bir Ingress, yalnızca IPv4 destekleyen bir ALB örneğiyle ilişkilendirilmişse sunucu grupları için IPv6 arka uç eklemeyi etkinleştiremezsiniz.
Service ve ALB Ingress'i çift yığın için yapılandırın. Çift yığın ALB örneği oluşturduktan sonra sunucu grubuna hem IPv4 hem de IPv6 arka uç sunucuları ekleyebilirsiniz.
|
Yapılandırma nesnesi |
Parametre |
Değer |
Açıklama |
YAML örneği |
|
Service |
|
|
Service için kullanılabilir IP adresi türlerini belirtir. |
|
|
|
|
Service için IP ilkesini ayarlar ve çift yığın ağlarını etkinleştirir. |
||
|
ALB Ingress |
|
|
Sunucu grubu için IPv6 arka uç eklemeyi etkinleştirir. |
|
QPS kısıtlamayı yapılandırın
Yönlendirme kuralları için QPS kısıtlamayı etkinleştirmek üzere aşağıdaki ek açıklamayı (annotation) ekleyin.
|
Ek Açıklama |
Açıklama |
YAML örneği |
|
|
Yönlendirme kuralları için QPS sınırını belirtir. Geçerli değerler: 1 ile 1.000.000 arasındadır. |
|
Slow start
Slow start, yeni eklenen Pod'lara gelen trafiği kademeli olarak artırarak ani trafik artışlarından kaynaklanan aşırı yüklenmeyi önler.
|
Parametre |
Açıklama |
YAML örneği |
|
|
Slow start özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan olarak devre dışıdır.
|
|
|
|
Saniye cinsinden slow start ramp-up süresini belirtir. Geçerli değerler: 30–900. Varsayılan: 30. |
Bağlantı boşaltma
Bir Pod Terminating durumuna geçtiğinde, ALB Ingress bu Pod'u sunucu grubundan kaldırır ancak mevcut bağlantıları hemen kapatmaz. Bu durum istek hatalarına neden olabilir veya düzgün kapatmayı engelleyebilir. Bağlantı boşaltma, mevcut bağlantıları kapatmadan önce yapılandırılabilir bir zaman aşımı süresi boyunca açık tutar. Daha fazla bilgi için bkz. ALB Ingress ile hizmetleri düzgün şekilde kapatmak için bağlantı boşaltma kullanımı.
ALB Ingress, bağlantı boşaltma işlemi tamamlanana kadar Pod'ların çalışır durumda kalmasını garanti etmez. Kapatma sırasında Pod erişilebilirliğini kontrol etmek için spec.terminationGracePeriodSeconds parametresini yapılandırın veya preStop Hook kullanın.
|
Parametre |
Açıklama |
YAML örneği |
|
|
Bağlantı boşaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir.
|
|
|
|
Saniye cinsinden bağlantı boşaltma zaman aşımını belirtir. Geçerli değerler: [0, 900]. Varsayılan: 300. |
AZ'lar arası yük dengelemeyi devre dışı bırakma
ALB, varsayılan olarak trafiği kullanılabilirlik alanları arasında dağıtır. AZ'lar arası yük dengelemeyi devre dışı bırakmak, trafiği yalnızca aynı alandaki arka uç hizmetlerine kısıtlar.
AZ'lar arası yük dengelemeyi devre dışı bırakırsanız her kullanılabilirlik alanında yeterli arka uç kaynağı bulunduğundan emin olun.
AZ'lar arası yük dengelemeyi devre dışı bırakmak için aşağıdaki örneği kullanın:
|
Parametre |
Açıklama |
YAML örneği |
|
|
AZ'lar arası yük dengelemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan olarak etkindir.
|
|