Tam geçişten önce trafiği başlık, çerez veya ağırlık bazında yeni hizmet sürümlerine kademeli olarak yönlendirin.
Arka plan
Hem aşamalı sürümler (canary sürümleri olarak da bilinir) hem de mavi-yeşil dağıtımlar, eski sürümün yanında yeni bir sürümü çalıştırır ve trafiğin bir kısmını buna yönlendirir. Sistem kararlı hale geldiğinde tüm trafik yeni sürüme geçer ve eski sürüm devre dışı bırakılır.
ACK Nginx Ingress Controller, ek açıklamalarla (annotation) çalışan iki trafik bölme yöntemini destekler:
| Yöntem | Durum | Notlar |
|---|---|---|
canary-* ek açıklamaları |
Aktif | Resmi topluluk yöntemi. Yeni yapılandırmaların tümünde bunu kullanın. |
service-* ek açıklamaları |
Kullanımdan kaldırıldı | Nginx Ingress Controller v1.12 ve sonraki sürümlerde artık mevcut değildir. Kullanmayın. |
Kullanım senaryoları
-
İstemci isteklerine dayalı trafik bölme: Yalnızca istek belirli bir başlık veya çerez içerdiğinde (örneğin,
foo=bar) trafiği yeni sürüme yönlendirin. Diğer istekler eski sürüme gitmeye devam eder. Sistem kararlı hale geldiğinde tüm trafiği yeni sürüme aktarın. -
Hizmet ağırlığına dayalı trafik bölme: Trafiğin sabit bir yüzdesini (örneğin %20) yeni sürüme yönlendirin. Tüm trafik yeni sürüme geçene kadar bu yüzdeyi kademeli olarak artırın.
Desteklenen trafik bölme boyutları:
İstek başlığı — aşamalı sürümler ve A/B testleri için uygundur
Çerez — aşamalı sürümler ve A/B testleri için uygundur
Sorgu parametresi — aşamalı sürümler ve A/B testleri için uygundur
Hizmet ağırlığı — mavi-yeşil dağıtımlar için uygundur
canary-* ek açıklama yöntemi
Ek açıklama referansı
Tüm canary yapılandırmaları nginx.ingress.kubernetes.io/canary: "true" ek açıklamasını gerektirir. Diğer ek açıklamalar yönlendirme mantığını tanımlar.
| Ek Açıklama | Açıklama | Min. sürüm |
|---|---|---|
nginx.ingress.kubernetes.io/canary |
Canary özelliğini etkinleştirir. Diğer herhangi bir canary ek açıklamasının etkili olması için true olarak ayarlanmalıdır. Geçerli değerler: true, false. |
>=v0.22.0 |
nginx.ingress.kubernetes.io/canary-by-header |
İstekleri bir istek başlığına göre canary hizmetine yönlendirir. Özel değerler: always (her zaman canary'e yönlendirir), never (asla canary'e yönlendirmez). Bir değer belirtilmezse, başlık mevcut olduğunda trafik iletilir. |
>=v0.22.0 |
nginx.ingress.kubernetes.io/canary-by-header-value |
canary-by-header tarafından belirtilen başlık tam bir değerle eşleştiğinde istekleri canary hizmetine yönlendirir. canary-by-header ile birlikte kullanılmalıdır. |
>=v0.30.0 |
nginx.ingress.kubernetes.io/canary-by-header-pattern |
canary-by-header tarafından belirtilen başlık bir düzenli ifadeyle eşleştiğinde istekleri canary hizmetine yönlendirir. canary-by-header ile birlikte kullanılmalıdır. |
>=v0.44.0 |
nginx.ingress.kubernetes.io/canary-by-cookie |
İstekleri bir çereze göre canary hizmetine yönlendirir; örneğin, nginx.ingress.kubernetes.io/canary-by-cookie: foo. Çerez değerleri: always (foo=always canary'e yönlendirir), never (foo=never yönlendirmez). Trafik yalnızca çerez mevcut olduğunda ve değeri always olduğunda iletilir. |
>=v0.22.0 |
nginx.ingress.kubernetes.io/canary-weight |
İsteklerin bir yüzdesini ağırlığa göre canary hizmetine yönlendirir. Aralık: 0 ile canary-weight-total (varsayılan 100). |
>=v0.22.0 |
nginx.ingress.kubernetes.io/canary-weight-total |
Toplam ağırlık paydasını ayarlar. Varsayılan: 100. |
>=v1.1.2 |
Ek açıklama önceliği (azalan sırada):
canary-by-header > canary-by-cookie > canary-weight
Her Ingress kuralı yalnızca bir canary Ingress'i destekler. Ek canary Ingress'leri yoksayılır.
1. Adım: Hizmeti dağıtın
Bir Nginx hizmeti dağıtın ve Nginx Ingress Controller ile Katman 7 alan adı erişimi için açığa çıkarın.
-
Bir Deployment ve bir Service oluşturun. Aşağıdakileri
nginx.yamldosyasına kaydedin.Manifesto dosyasını uygulayın:
kubectl apply -f nginx.yaml -
Ingress'i oluşturun. Aşağıdakileri
ingress.yamldosyasına kaydedin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release spec: ingressClassName: nginx rules: - host: www.example.com http: paths: # Old version of the service. - path: / backend: service: name: old-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release spec: rules: - host: www.example.com http: paths: # Old version of the service. - path: / backend: serviceName: old-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress.yaml -
Dağıtımı doğrulayın. Harici IP adresini alın:
kubectl get ingressYönlendirme erişimini kontrol edin:
curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
old
2. Adım: Yeni hizmet sürümünü yayınlayın
Yeni Nginx sürümünü dağıtın ve canary yönlendirme kurallarını yapılandırın.
-
Yeni Deployment ve Service'i oluşturun. Aşağıdakileri
nginx1.yamldosyasına kaydedin.Manifesto dosyasını uygulayın:
kubectl apply -f nginx1.yaml -
Trafiği yeni sürüme yönlendirmek için bir canary Ingress oluşturun. Üç strateji mevcuttur. Strateji A: İstek başlığına göre yönlendirme Yalnızca
foobaşlığıbardeğerine eşit olduğunda istekleri yeni sürüme yönlendirin. Diğer istekler eski sürüme gider. Aşağıdakileriingress1.yamldosyasına kaydedin. v1.19 ve sonraki sürümlere sahip kümeler için:foo: barbaşlığıyla: Trafiğin %100'ünew-nginxhizmetine gider (canary-by-headervecanary-by-header-valueile kontrol edilir).foo: barbaşlığı olmadan: Trafiğin %50'sinew-nginxhizmetine gider (canary-weightile kontrol edilir).
v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release-canary annotations: # Enable canary routing. nginx.ingress.kubernetes.io/canary: "true" # Route to new-nginx only when the foo header equals bar. nginx.ingress.kubernetes.io/canary-by-header: "foo" nginx.ingress.kubernetes.io/canary-by-header-value: "bar" spec: ingressClassName: nginx rules: - host: www.example.com http: paths: # New version of the service. - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release-canary annotations: nginx.ingress.kubernetes.io/canary: "true" nginx.ingress.kubernetes.io/canary-by-header: "foo" nginx.ingress.kubernetes.io/canary-by-header-value: "bar" spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın ve doğrulayın:
kubectl apply -f ingress1.yaml kubectl get ingressBaşlık olmadan test edin (eski sürüme yönlendirilir):
curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
oldfoo: barbaşlığıyla test edin (yeni sürüme yönlendirilir):curl -H "Host: www.example.com" -H "foo: bar" http://<EXTERNAL_IP>Beklenen çıktı:
newStrateji B: Başlığa göre yönlendirme ve kalan trafiği ağırlığa göre bölme
foo=bariçeren tüm istekleri yeni sürüme, diğer isteklerin ise %50'sini yeni sürüme yönlendirin.ingress1.yamldosyasını aşağıdaki içerikle güncelleyin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release-canary annotations: nginx.ingress.kubernetes.io/canary: "true" # Route to new-nginx when foo header equals bar. nginx.ingress.kubernetes.io/canary-by-header: "foo" nginx.ingress.kubernetes.io/canary-by-header-value: "bar" # For requests that don't match the header rule, route 50% to new-nginx. nginx.ingress.kubernetes.io/canary-weight: "50" spec: ingressClassName: nginx rules: - host: www.example.com http: paths: - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release-canary annotations: nginx.ingress.kubernetes.io/canary: "true" nginx.ingress.kubernetes.io/canary-by-header: "foo" nginx.ingress.kubernetes.io/canary-by-header-value: "bar" nginx.ingress.kubernetes.io/canary-weight: "50" spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress1.yamlStrateji C: Yalnızca ağırlığa göre yönlendirme
Başlık veya çerezden bağımsız olarak trafiğin %50'sini yeni sürüme yönlendirin.
ingress1.yamldosyasını aşağıdaki içerikle güncelleyin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release-canary annotations: nginx.ingress.kubernetes.io/canary: "true" # Route 50% of all traffic to new-nginx. Default total weight is 100. nginx.ingress.kubernetes.io/canary-weight: "50" spec: ingressClassName: nginx rules: - host: www.example.com http: paths: - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release-canary annotations: nginx.ingress.kubernetes.io/canary: "true" nginx.ingress.kubernetes.io/canary-weight: "50" spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress1.yamlDoğrulayın: Bu komutu birkaç kez çalıştırın. Yanıtların yaklaşık %50'si
newdöndürmelidir.curl -H "Host: www.example.com" http://<EXTERNAL_IP>
3. Adım: Trafik geçişini tamamlayın
Yeni sürüm kararlı hale geldiğinde, eski sürümü devre dışı bırakın.
-
Eski Service'i yeni Deployment'a yönlendirmek için
nginx.yamldosyasını güncelleyin.Güncellemeyi uygulayın:
kubectl apply -f nginx.yaml -
Tüm trafiğin yeni sürüme gittiğini doğrulayın:
kubectl get ingress curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
new -
Canary Ingress'i silin:
kubectl delete ingress gray-release-canary -
Eski Deployment'ı ve yeni Service'i silin:
kubectl delete deploy old-nginx kubectl delete svc new-nginx
service-* ek açıklama yöntemi
service-* ek açıklaması, Nginx Ingress Controller v1.12 ve sonraki sürümlerde artık mevcut değildir. Kullanmayın.
Ek açıklama referansı
| Ek Açıklama | Açıklama |
|---|---|
nginx.ingress.kubernetes.io/service-match |
İstek özelliklerini bir hizmetle eşleyen yönlendirme kurallarını tanımlar. Söz dizimi: nginx.ingress.kubernetes.io/service-match: | <service-name>: <match-rule>. Desteklenen eşleme türleri: header, cookie, query. Eşleme formatları: düzenli ifade /regular expression/, tam eşleşme "exact value". Örnekler: new-nginx: header("foo", /^bar$/); new-nginx: header("foo", "bar"); new-nginx: cookie("foo", /^sticky-.+$/); new-nginx: query("foo", "bar"). |
nginx.ingress.kubernetes.io/service-weight |
Eski ve yeni hizmet sürümleri arasındaki trafik ağırlıklarını ayarlar. Söz dizimi: nginx.ingress.kubernetes.io/service-weight: | <new-svc-name>:<new-svc-weight>, <old-svc-name>:<old-svc-weight>. Örnek: new-nginx: 20, old-nginx: 60. |
1. Adım: Hizmeti dağıtın
Bir Nginx hizmeti dağıtın ve Nginx Ingress Controller ile Katman 7 alan adı erişimi için açığa çıkarın.
-
Bir Deployment ve bir Service oluşturun. Aşağıdakileri
nginx.yamldosyasına kaydedin.Manifesto dosyasını uygulayın:
kubectl apply -f nginx.yaml -
Ingress'i oluşturun. Aşağıdakileri
ingress.yamldosyasına kaydedin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release spec: ingressClassName: nginx rules: - host: www.example.com http: paths: # Old version of the service. - path: / backend: service: name: old-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: old-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress.yaml -
Dağıtımı doğrulayın. Harici IP adresini alın:
kubectl get ingressYönlendirme erişimini kontrol edin:
curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
old
2. Adım: Yeni hizmet sürümünü yayınlayın
Yeni Nginx sürümünü dağıtın ve yönlendirme kurallarını yapılandırın.
-
Yeni Deployment ve Service'i oluşturun. Aşağıdakileri
nginx1.yamldosyasına kaydedin.Manifesto dosyasını uygulayın:
kubectl apply -f nginx1.yaml -
gray-releaseIngress'ini değiştirin. Üç strateji mevcuttur. Strateji A: İstek başlığına göre yönlendirme Yalnızcafoobaşlığıbarile eşleştiğinde istekleri yeni sürüme yönlendirin.ingress.yamldosyasını aşağıdaki içerikle güncelleyin. v1.19 ve sonraki sürümlere sahip kümeler için:v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release annotations: # Route to new-nginx when the foo header matches ^bar$. nginx.ingress.kubernetes.io/service-match: | new-nginx: header("foo", /^bar$/) spec: ingressClassName: nginx rules: - host: www.example.com http: paths: # Old version of the service. - path: / backend: service: name: old-nginx port: number: 80 pathType: ImplementationSpecific # New version of the service. - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release annotations: nginx.ingress.kubernetes.io/service-match: | new-nginx: header("foo", /^bar$/) spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: old-nginx servicePort: 80 - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın ve doğrulayın:
kubectl apply -f ingress.yaml kubectl get ingressBaşlık olmadan test edin (eski sürüme yönlendirilir):
curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
oldfoo: barbaşlığıyla test edin (yeni sürüme yönlendirilir):curl -H "Host: www.example.com" -H "foo: bar" http://<EXTERNAL_IP>Beklenen çıktı:
newStrateji B: Başlığa göre yönlendirme ve ağırlık tabanlı bölme
foo=barile eşleşen istekleri her iki sürüme de yönlendirin; %50'si yeni sürüme, %50'si eski sürüme gidecek şekilde ayarlayın.ingress.yamldosyasını aşağıdaki içerikle güncelleyin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release annotations: nginx.ingress.kubernetes.io/service-match: | new-nginx: header("foo", /^bar$/) # Of the matching requests, route 50% to new-nginx and 50% to old-nginx. nginx.ingress.kubernetes.io/service-weight: | new-nginx: 50, old-nginx: 50 spec: ingressClassName: nginx rules: - host: www.example.com http: paths: - path: / backend: service: name: old-nginx port: number: 80 pathType: ImplementationSpecific - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release annotations: nginx.ingress.kubernetes.io/service-match: | new-nginx: header("foo", /^bar$/) nginx.ingress.kubernetes.io/service-weight: | new-nginx: 50, old-nginx: 50 spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: old-nginx servicePort: 80 - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress.yamlTest komutunu birkaç kez çalıştırın.
foo: baristeklerinin yaklaşık %50'sinewdöndürmelidir.Strateji C: Yalnızca ağırlığa göre yönlendirme
Trafiğin %50'sini yeni sürüme yönlendirin.
ingress.yamldosyasını aşağıdaki içerikle güncelleyin.v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release annotations: # Route 50% of all traffic to new-nginx. nginx.ingress.kubernetes.io/service-weight: | new-nginx: 50, old-nginx: 50 spec: ingressClassName: nginx rules: - host: www.example.com http: paths: - path: / backend: service: name: old-nginx port: number: 80 pathType: ImplementationSpecific - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release annotations: nginx.ingress.kubernetes.io/service-weight: | new-nginx: 50, old-nginx: 50 spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: old-nginx servicePort: 80 - path: / backend: serviceName: new-nginx servicePort: 80Manifesto dosyasını uygulayın:
kubectl apply -f ingress.yamlDoğrulayın: Bu komutu birkaç kez çalıştırın. Yanıtların yaklaşık %50'si
newdöndürmelidir.curl -H "Host: www.example.com" http://<EXTERNAL_IP>
3. Adım: Trafik geçişini tamamlayın
Yeni sürüm kararlı hale geldikten sonra, eski sürümü devre dışı bırakın.
-
Güncellemeyi uygulayın:
v1.19 ve sonraki sürümlere sahip kümeler için
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: gray-release spec: ingressClassName: nginx rules: - host: www.example.com http: paths: # New version of the service. - path: / backend: service: name: new-nginx port: number: 80 pathType: ImplementationSpecificv1.19'dan önceki kümeler için
apiVersion: networking.k8s.io/v1beta1 kind: Ingress metadata: name: gray-release spec: rules: - host: www.example.com http: paths: - path: / backend: serviceName: new-nginx servicePort: 80kubectl apply -f ingress.yaml -
Tüm trafiğin yeni sürüme gittiğini doğrulayın:
kubectl get ingress curl -H "Host: www.example.com" http://<EXTERNAL_IP>Beklenen çıktı:
new -
Eski Deployment'ı ve Service'i silin:
kubectl delete deploy <Deployment_name> kubectl delete svc <Service_name>