Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Upgrade the NGINX Ingress Controller

Son Güncelleme:Nov 03, 2026

Küme yükseltmesinden sonra eski küme API'leri eşleşen bir NGINX Ingress Controller sürümü gerektirebilir. Eski eklenti sürümleri güvenlik ve kararlılık riskleri taşıyabilir ve özellik eksikliklerine sahip olabilir; bu nedenle en son sürüme geçiş yapın. Yükseltmeler aşamalı olarak gerçekleşir; hizmet trafiğinin kesintisiz kalmasını sağlamak için süreci boyunca eklentiyi ve iş yükünüzü izleyin.

Önemli

Ingress NGINX açık kaynak projesi Mart 2026'dan itibaren bakım güncellemeleri almayacağından, Container Service for Kubernetes NGINX Ingress Controller eklentisinin bakımını durduracaktır. Devam etmeden önce ilişkili riskleri anlayın. Daha fazla bilgi için bkz. [[Ürün Duyurusu] Nginx Ingress Controller için bakım sonu](t3212739.xdita#).

Yükseltme süreci

NGINX Ingress Controller, veri düzleminde kritik bir eklentidir ve yüksek kararlılık gereksinimlerine sahiptir.

Yeni sürüm, NGINX Ingress Controller üzerinde birçok özel değişiklik içerebilir ve büyük sürüm farkları bazı yapılandırma uyumsuzluklarına neden olabilir. Bu uyumsuzluklar yükseltmeden hemen sonra ortaya çıkmayabilir. Bu nedenle, eklentiyi tek adımda en son sürüme yükseltmek risklidir.

NGINX Ingress Controller'ı yükselttikten sonra eklentinin ve iş yükünüzün beklendiği gibi çalıştığından emin olmak için yükseltme aşamalı olarak gerçekleştirilir. Yükseltme sırasında iş yükü durumunu kontrol edebilir ve bir sorun oluşursa geri alabilirsiniz.

image

Başlamadan önce

  • NGINX Ingress Controller artık v1.2 ve daha eski sürümleri desteklememektedir. Daha fazla bilgi için bkz. [[Ürün Duyurusu] Nginx Ingress Controller v1.2 ve Önceki Sürümler İçin Bakım Sonu Duyurusu](t2767923.xdita#). Güncel olmayan eklenti sürümleri, daha yeni sürümler tarafından desteklenen özellikleri ve düzeltmeleri kullanamaz, zamanında teknik destek alamaz ve düzeltilemeyen güvenlik açıkları riskiyle karşı karşıya kalır. Eklentiyi yükseltin.

  • Eklentiyi yükseltmeden önce, sorunları erken tespit edebilmeniz için hizmet trafiğini izlemenize olanak tanıyan bir yönteminiz olduğundan emin olun. Hizmet trafiğini kontrol etmek için Simple Log Service (SLS) veya Managed Service for Prometheus kullanın. Bu iki gözlem yöntemi için yapılandırma talimatları hakkında bilgi edinmek için bkz. nginx-ingress-controller erişim günlüğünü analiz etme ve izleme ve Managed Service for Prometheus yapılandırma.

  • Eklentinin sağlıklı olduğunu, tüm Pod'ların Ready durumunda olduğunu ve hata günlüğü bulunmadığını doğrulayın.

  • Yatay Pod Otomatik Ölçeklendirici (HPA) gibi otomatik ölçeklendirme kurallarının kullanılmadığından emin olun. Kullanılıyorsa, yükseltmeden önce bunları silin ve yükseltme tamamlandıktan sonra yeniden oluşturun. Bir HPA kaynağını silmenin etkisi hakkında bilgi edinmek için bkz. Ön kontrol ayrıntıları.

  • NGINX Ingress Controller için LoadBalancer hizmetinin sağlıklı olduğunu (varsayılan ad nginx-ingress-lb şeklindedir) ve anormal olay bildirilmediğini doğrulayın.

  • Yükseltme sırasında eklentiyi veya Ingress kurallarını değiştirmeyin.

  • NGINX Ingress Controller sürümünüz v0.44'ten önceyse, daha sonraki bir sürüme yükseltirken ön ek eşleştirme farklılıklarına dikkat edin. Daha fazla bilgi için bkz. Yol eşleştirme mantığı değişiklikleri.

  • Eklenti yükseltmesi kademeli yayınlama kullanır. İlk olarak, yükseltme hedef sürümü çalıştıran bir NGINX Ingress Pod'u oluşturur. Trafik doğrulaması sorun olmadığını onayladıktan sonra, yuvarlak güncelleme tetiklemek için Confirm öğesine tıklayın. NGINX Ingress Pod'unun oluşturulması ve zamanlanması için kümede yeterli planlanabilir düğüm bulunduğundan emin olun.

Yordam

  1. ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde Components and Add-ons seçeneğine tıklayın.

  3. Add-ons sayfasında, NGINX Ingress Controller eklentisini bulun ve eklentinin sağ alt köşesindeki Upgrade seçeneğine tıklayın.

  4. Görüntülenen yükseltme panelinde, yükseltmeyi başlatmak için Start seçeneğine tıklayın ve onaylayın.

    Not

    Yükseltme sırasında bu sayfadan istediğiniz zaman ayrılabilir ve Add-ons ardından Progress seçeneklerine tıklayarak sürece dönebilirsiniz.

  5. Sürecin ilk aşaması bir ön kontrol çalıştırır. Ön kontrol tamamlandığında, süreç otomatik olarak sonraki aşamaya geçer.

    Ön kontrol başarısız olursa, Check Report sayfasını açmak için Precheck altındaki View Details seçeneğine tıklayın. Başarısız olan kontrol öğelerini sorun giderin. Daha fazla bilgi için bkz. Ön kontrol ayrıntıları. Sorunu çözdükten sonra, yükseltmeyi yeniden başlatmak için Retry seçeneğine tıklayın.

  6. Doğrulama aşaması tamamlandıktan sonra yükseltme duraklar. Eklenti durumunu ve iş yükü durumunu doğrulayın. Doğrulama yöntemleri hakkında bilgi edinmek için bkz. Doğrulama aşaması ayrıntıları.

    • Ölçeklendirme genişletme işlemi başarısız olursa bkz. Doğrulama veya yayınlama aşamasında Pod ölçeklendirmesi başarısız olursa ne yapmalıyım?. Ayrıca, kümede Pod'un başlatılamamasının belirli nedenini kontrol edin. Sorunu çözdükten sonra, bu aşamayı yeniden denemek için Retry seçeneğine tıklayın.

    • Bir iş yükü doğrulama sorunu oluşursa, geri alma işlemi gerçekleştirmek için Rollback seçeneğine tıklayın. Geri alma tamamlandıktan sonra yükseltme sona erer. Eklenti yönetimi sayfasına dönün ve yükseltmeyi yeniden başlatmak için Upgrade seçeneğine tıklayın.

  7. Doğrulama aşamasında sorun olmadığını onayladıktan sonra, yayınlama aşamasına geçmek için Continue seçeneğine tıklayın. Yayınlama aşamasındaki yuvarlak güncelleme tamamlandığında yükseltme duraklar. Eklenti ve iş yükü durumu üzerinde son bir kontrol gerçekleştirin. İş yükü doğrulaması başarısız olursa, geri alma işlemi gerçekleştirmek için Rollback seçeneğine tıklayın. Geri alma tamamlandıktan sonra yükseltme sona erer. Eklenti yönetimi sayfasına dönün ve yeniden başlatmak için Upgrade seçeneğine tıklayın.

  8. Eklenti ve iş yükü durumunda anormallik olmadığını onayladıktan sonra, yükseltmeyi tamamlamak için Continue seçeneğine tıklayın.

    Not

    Yükseltme sürecinin toplam süresini bir hafta içinde tutun.

Ön kontrol ayrıntıları

Ön kontrol tablosu

Kontrol öğesi

Kontrol içeriği

Sorun giderme

Dağıtım mevcut

Eklenti Dağıtımı (kube-system/nginx-ingress-controller) mevcuttur.

-

Dağıtım sağlığı

Eklenti Dağıtımı tarafından yönetilen tüm Pod'lar Ready durumundadır ve yuvarlak güncelleme gibi kararsız bir durumda değildir.

-

Pod hata günlükleri

En son 200 Pod günlük girişini kontrol edin. Error veya Fatal düzeyinde hata günlüğü bulunmamalıdır.

Mevcut günlükler, eklentinin yapılandırma hataları veya diğer sorunlar nedeniyle yakın zamanda hata bildirdiğini gösterebilir. Yükseltmeyi yeniden başlatmadan önce sorunu çözün. Günlüklere dayalı olarak bir sorunu çözmek için bkz. NGINX Ingress sorunlarını giderme.

LoadBalancer hizmeti sağlığı

İlk olarak, NGINX Ingress Controller için LoadBalancer hizmetinin (kube-system/nginx-ingress-lb) mevcut olup olmadığını kontrol edin. Mevcutsa, sistem Hizmetin herhangi bir hata olayı içerip içermediğini ayrıca kontrol eder.

Eksik bir Hizmet de Warning olayına sahip olarak kabul edilir.

Hizmet mevcut değilse, bkz. Önemli notlar ve yüksek riskli işlemler ve "NGINX Ingress Controller eklentisi yüklüyken kube-system ad alanında nginx-ingress-lb Hizmetini manuel olarak silme" bölümündeki onarım yordamını izleyin.

Hizmet mevcut ancak anormal bir olay içeriyorsa, olay içeriğine göre bir çözüm bulun. Daha fazla bilgi için bkz. Hizmet hata olayları ve çözümleri. Hizmet bir LoadBalancer değilse bu kontrol atlanır.

HPA

Eklenti Dağıtımı HPA kullanmaz. HPA kullanılırsa, otomatik ölçeklendirme ilkesi eklenti yükseltmesi sırasında yükseltme durumunu bozabilir.

Uyarı

HPA kaynağını silmek, nesneyi ve ölçeklendirme eşiklerini kaldırır. Yükseltme bunları otomatik olarak geri yüklemez. Daha sonra aynı eşikleri yeniden uygulamak için öncelikle spec'i dışa aktarın, örneğin kubectl get hpa -o yaml komutunu çalıştırarak.

Yükseltme sırasında HPA kaynağını kümeden silin ve yükseltme tamamlandıktan sonra yeniden etkinleştirin.

Dağıtım şablonu

Eklenti Dağıtım şablonu yalnızca uyumlu değişiklikler içerir.

NGINX Ingress Controller Dağıtımına daha önce yaptığınız bazı özel yapılandırmalar veya değişiklikler, yükseltme sırasında otomatik olarak korunmayabilir.

  • Aşağıdaki alanlar yükseltmeden sonra korunur ve yeni eklenti şablonunda özel parametreler olarak girilir:

    • Çoğaltma sayısı (replicas)

    • Pod etiketleri (template.metadata.labels)

    • Düğüm seçici (template.spec.nodeSelector)

    • Toleranslar (template.spec.tolerations)

    • Denetleyici konteyneri için kaynak sınırları (template.spec.containers[0].resources)

  • Aşağıdaki alanlar ön kontrolü etkilemez ancak yükseltmeden sonra atılır:

    • Pod Ek Açıklamasındaki (template.metadata.annotations) redeploy-timestamp.

    • Pod Ek Açıklamasındaki kubectl.kubernetes.io/restartedAt.

    • Pod Ek Açıklamasındaki scheduler.alpha.kubernetes.io/critical-pod.

    • Görüntünün imagePullPolicy değeri.

    • template.spec.containers.securityContext.procMount Default olduğunda atılır.

    • Webhook yapılandırmaları (çalışma zamanı parametreleri, bağlanan birimler ve bağlantı noktaları).

Bu şablon değişiklikleri kontrolün başarısız olmasına neden olmaz. Diğer değişiklikler ön kontrolün başarısız olmasına ve yükseltmenin başarı oranını etkilemesine neden olur. Bunlar arasında yetkisiz şablon değişiklikleri ve yükseltme gereksinimlerini karşılamayan eski sürümler yer alır. Kontrollerin başarısız olmasının yaygın nedenleri şunlardır:

  • Enterprise Distributed Application Service (EDAS) gibi bir eklenti özel Birim mount etmek için kullanılır. Yükseltme sırasında ilgili EDAS özelliklerini geçici olarak devre dışı bırakın ve yükseltme tamamlandıktan sonra geri yükleyin.

  • podAntiAffinity standart şablondan farklıdır; bunun nedeni eklenti şablonunun değişmiş olması olabilir (örneğin, required değerinden preferred değerine). podAntiAffinity değerini önce standart şablonla eşleşecek şekilde manuel olarak değiştirin.

  • Özel düğümleri belirtmek için nodeAffinity kullanılır. Bunun yerine nodeSelector kullanın.

Eğer Dağıtım şablonu kontrolü başarısız olursa, şablonu manuel olarak geri yükleyerek sorunu çözebilirsiniz.

Ingress yapılandırması

Kümedeki Ingress kaynakları yalnızca uyumlu özellikler kullanır.

Kümedeki Ingress kaynakları uyumsuz özellikler kullanıyorsa, iş yükü yükseltmeden sonra trafiği normal şekilde iletemeyebilir ve kullanılamaz hale gelebilir. Sorunu tespit etmek ve düzeltmek için aşağıdaki Yükseltme uyumluluğu bölümüne bakın.

Eklenti yapılandırması

Eklenti ConfigMap'i (kube-system/nginx-configuration) uyumsuz yapılandırmalar içermez.

Kümedeki ConfigMap uyumsuz özellikler kullanıyorsa, iş yükü yükseltmeden sonra trafiği normal şekilde iletemeyebilir ve kullanılamaz hale gelebilir. Sorunu tespit etmek ve düzeltmek için aşağıdaki Yükseltme uyumluluğu bölümüne bakın.

Yükseltme uyumluluğu

Eklentinin geliştirilmesi ve bakımı sırasında, yeni bir NGINX Ingress Controller sürümü yeni özellikler getirebilir, mevcut özellikleri iyileştirebilir veya güvenlik sorunlarını düzeltebilir. Ancak, dahili mimari ayarlamaları veya bağımlılık kütüphanelerindeki değişiklikler gibi değişiklikler önceki sürümlerle uyumluluk farklarına da neden olabilir. NGINX Ingress Controller değişiklik günlüğü için bkz. NGINX Ingress controller.

Maksimum istek üst bilgisi sayısı

Etkilenen sürümler: v1.14.5-release.4 öncesi (v1.14.5-release.4 hariç).

CVE-2026-49975'i düzeltmek için v1.14.5-release.4 sürümünde max_headers yönergesi eklendi. Varsayılan olarak, tek bir isteğin 1.000 HTTP üst bilgisini aşmamasını sınırlar. Sınırı aşan istekler 400 döndürür ve bağlantı kapatılır. Yükseltmeden önce, iş yükünüzdeki tek bir isteğin 950 HTTP üst bilgisini aşmadığından emin olun. Bu, yol üzerindeki diğer ağ geçitleri tarafından eklenen HTTP üst bilgileri için kapasite bırakır.

real_ip_header davranış değişiklikleri

Etkilenen sürümler: v1.13.8-release.1 öncesi (v1.13.8-release.1 hariç).

v1.13.x, hem use-proxy-protocol hem de use-forwarded-headers etkinleştirildiğinde gerçek istemci IP'sinin elde edilme şeklini değiştirir. Davranış, gerçek istemci IP'sini elde etmek için PROXY protokolünü kullandığınızda, use-forwarded-headers da etkinleştirildiğinde ve proxy-real-ip-cidr varsayılan değeri 0.0.0.0/0 olarak kaldığında uygulanır. Tüm PROXY protokol adresleri daha sonra güvenilir proxy'ler olarak kabul edilir. İstemci tarafından sağlanan bir X-Forwarded-For daha sonra güvenilebilir, bu da istemci IP'sinin sahte kullanılmasına olanak tanır.

Yükseltme sırasında nginx-ingress-controller yapılandırmasını dikkatlice doğrulayın. Hem use-proxy-protocol: "true" hem de use-forwarded-headers: "true" ayarlarını korumak için, proxy-real-ip-cidr değerini varsayılan 0.0.0.0/0 değerinden, Network Load Balancer (NLB) veya Classic Load Balancer (CLB) örneğinin Yerel IP CIDR'si gibi gerçek güvenilir TCP eşlerinin ve ön uç L7 proxy çıkışlarının CIDR'lerine daraltın. TCP yük dengeleyicisine doğrudan ulaşan trafik daha sonra PROXY protokol adresini kullanmaya devam eder ve yalnızca güvenilir ön uç proxy'lerinden gelen forwarded-for zincirleri ayrıştırılır.

Varsayılan güvenlik yapılandırması ayarlamaları

Etkilenen sürümler: v1.12.6-release.1 öncesi (v1.12.6-release.1 hariç).

ingress-nginx güvenliğini artırmak için v1.12.6-release.1 sürümünde bazı güvenlik yapılandırmalarının varsayılan değerleri değiştirildi. Etkilenen yapılandırmalar şunları içerir:

  • annotations-risk-level varsayılan düzeyi Critical değerinden High değerine düşürülmüştür. Bu değişiklik, kümedeki Ingress kaynaklarında bulunan mevcut Critical düzeyi Ek Açıklamaların (Annotations), örneğin snippet ile ilgili Ek Açıklamaların, kullanılamaz hale gelmesine neden olur.

  • allow-cross-namespace-resources değeri true değerinden false değerine değiştirilmiştir. Varsayılan olarak, bu yapılandırma ConfigMap ve Secrets gibi kaynaklara ad alanları arası başvuruları yasaklar.

  • strict-validate-path-type değeri false değerinden true değerine değiştirilmiştir. Bu yapılandırma, varsayılan olarak sıkı yol adresi doğrulamasını etkinleştirir. Bu, Exact ve Prefix türündeki yolların / ile başlaması gerektiği ve yalnızca harf, rakam, -, _, . ve ek / karakterleri içerebileceği anlamına gelir.

Bu güvenlik yapılandırmalarının yasakladığı özellikleri kullandıysanız veya kullanmak istiyorsanız, güvenlik riskini tamamen değerlendirin. Ardından, kube-system/nginx-configuration ConfigMap'ine yapılandırmalar ekleyerek özellikleri manuel olarak etkinleştirin.

Yerel NGINX doğrulaması varsayılan olarak devre dışı bırakılır

Etkilenen sürümler: v1.11.5-aliyun.1 öncesi (v1.11.5-aliyun.1 hariç).

CVE-2025-1974'ü düzeltmek için NGINX Ingress Controller, v1.11.5-aliyun.1 sürümünden başlayarak yerel NGINX doğrulamasını (nginx -t komut mantığı) varsayılan olarak devre dışı bırakır. NGINX Ingress Controller eklentisi doğrulama webhook'unu hala etkinleştirse de, doğrulama webhook'u snippet yapılandırmalarını kullanan kuralları doğrulamaz. Varsayılan olarak yalnızca standart snippet olmayan Ek Açıklamaları doğrular. Snippet'lerle yapılandırılan kurallar için, yapılandırmaları yalnızca NGINX çalışma zamanında oluşturulan hata günlükleri aracılığıyla kontrol edebilirsiniz. Güvenlik açığı hakkında daha fazla bilgi için bkz. Güvenlik Danışmanlığı: NGINX Ingress Controller Güvenlik Açıkları (CVE-2025-1974 ve İlgili CVE'ler).

Snippet Ek Açıklama özelliğini etkinleştirirseniz, ilgili Ingress kurallarını her değiştirdiğinizde NGINX Ingress Controller Pod günlüklerinde Error ile ilgili günlükleri kontrol edin:

kubectl logs -f <Nginx-ingress-pod-name> -n kube-system |grep Error

Yerel NGINX doğrulamasına hala ihtiyacınız varsa, riski tamamen değerlendirin ve ardından kube-system/nginx-configuration ConfigMap'ine enable-nginx-native-validation: "true" ekleyerek bunu manuel olarak etkinleştirin.

Snippet Ek Açıklamaları varsayılan olarak devre dışı bırakılır

Etkilenen sürümler: v1.9.3-aliyun.1 öncesi (v1.9.3-aliyun.1 hariç).

Güvenlik nedenleriyle, NGINX Ingress Controller v1.9.3-aliyun.1 sürümünden başlayarak tüm snippet Ek Açıklamalarını varsayılan olarak devre dışı bırakır. Bunlar şunları içerebilir:

  • nginx.ingress.kubernetes.io/configuration-snippet

  • nginx.ingress.kubernetes.io/server-snippet

  • nginx.ingress.kubernetes.io/stream-snippet

  • nginx.ingress.kubernetes.io/auth-snippet

  • nginx.ingress.kubernetes.io/modsecurity-snippet

Güvenlik ve kararlılık riskleri nedeniyle, gerekli özellikleri uygulamak için ilgili Ek Açıklamaları veya yapılandırma öğelerini kullanmaya öncelik verin.

Snippet Ek Açıklama özelliğine hala ihtiyacınız varsa, riski tamamen değerlendirin ve ardından kube-system/nginx-configuration ConfigMap'inde allow-snippet-annotations: "true" ekleyerek Ek Açıklama özelliğini manuel olarak etkinleştirin.

TLS'in önceki sürümleri desteklenmez

Etkilenen sürümler: v1.7.0-aliyun.1 öncesi (v1.7.0-aliyun.1 hariç).

TLS 1.1 ve önceki sürümler güvenlik sorunları içerdiğinden, yeni NGINX Ingress Controller sürümleri varsayılan olarak artık TLS 1.1 ve TLS 1.0 şifreleme yöntemlerini desteklemez. Bu nedenle, yükseltmeden önce iş yükünüzün TLS 1.1 veya önceki sürümlere bağlı olmadığından emin olun ve bu sürümleri yapılandırmadan kaldırın. ConfigMap değişiklikleri hemen etkili olur.

Örneğin, NGINX Ingress Controller eklentisinin ConfigMap'i (kube-system/nginx-configuration) aşağıdaki gibi yapılandırılmışsa:

ssl-protocols: SSLv3 SSLv2 TLSv1 TLSv1.1 TLSv1.2 TLSv1.3

İş yükünüzün etkilenmediğini onayladıktan sonra, bu satırı kaldırın ve varsayılan ayarı kullanın. Alternatif olarak, SSLv3, SSLv2, TLSv1 ve TLSv1.1 olmak üzere dört girişi kaldırın ve satırı şu şekilde değiştirin:

ssl-protocols: TLSv1.2 TLSv1.3

Daha önceki TLS şifreleme yöntemlerinin kullanımını zorunlu kılmak istiyorsanız, yapılandırma talimatları için bkz. Hangi TLS sürümleri desteklenir?.

nginx.ingress.kubernetes.io/rewrite-target uyumsuz kullanımı

Etkilenen sürümler: 0.22.0 öncesi (0.22.0 hariç).

  • Sürüm 0.22.0, nginx.ingress.kubernetes.io/rewrite-target Ek Açıklamasının kullanımını değiştirdi. 0.22.0 ve sonraki sürümlerde, rewrite-target kullanırken yakalama gruplarının kullanımını açıkça belirtmeniz gerekir.

  • 0.22.0 öncesi sürümlerdeki rewrite-target özelliği, en son sürümdeki rewrite-target özelliği ile uyumsuzdur. Eklenti yükseltmesinden önce, rewrite-target Ek Açıklaması yerine configuration-snippet kullanabilirsiniz.

Örneğin, 0.22.0 öncesi sürümlerde kural şöyledir:

Tam YAML örnek kodunu görüntülemek için genişletin

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
  name: rewrite
  namespace: default
spec:
  rules:
  - host: rewrite.bar.com
    http:
      paths:
      - path: /something/
        pathType: Prefix
        backend:
          service:
            name: http-svc
            port:
              number: 80
      - path: /something123/
        pathType: Prefix
        backend:
          service:
            name: http-svc-1
            port:
              number: 80

Şu şekilde değiştirin:

Tam YAML örnek kodunu görüntülemek için genişletin

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    # Use the rewrite directive. /something is the path in the path field, without the trailing slash.
    # Ingress contains multiple paths, so add multiple rewrite directives.
    nginx.ingress.kubernetes.io/configuration-snippet: |
      rewrite "(?i)/something(/|$)(.*)" /$2 break;
      rewrite "(?i)/something123(/|$)(.*)" /$2 break;
  name: rewrite
  namespace: default
spec:
  rules:
  - host: rewrite.bar.com
    http:
      paths:
      - path: /something/ # Keep this path consistent with the path in the earlier Ingress resource.
        pathType: Prefix
        backend:
          service:
            name: http-svc
            port:
              number: 80
      - path: /something123/ # Keep this path consistent with the path in the earlier Ingress resource.
        pathType: Prefix
        backend:
          service:
            name: http-svc-1
            port:
              number: 80

Yapılandırmayı yukarıdaki formata değiştirdikten sonra yükseltmeye devam edebilirsiniz. Yükseltme tamamlandıktan sonra, Ingress'i yeni sürümü kullanacak şekilde değiştirin.

YAML

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    # Reference the matched content.
    nginx.ingress.kubernetes.io/rewrite-target: /$2
  name: rewrite
  namespace: default
spec:
  rules:
  - host: rewrite.bar.com
    http:
      paths:
      # Use a capturing group.
      - path: /something(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: http-svc
            port:
              number: 80
      # Use a capturing group.
      - path: /something123(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: http-svc-1
            port:
              number: 80

Yerel NGINX root ve alias yönergeleri v1.2.1 ve sonraki sürümlerde artık desteklenmiyor

Etkilenen sürümler: v1.2.1-aliyun.1 öncesi (v1.2.1-aliyun.1 hariç).

root ve alias yönergelerinde güvenlik sorunları bulunduğundan, yeni NGINX Ingress Controller sürümleri (NGINX Ingress controller) artık root ve alias yönergelerini desteklemez. Bu nedenle, yükseltmeden önce Ingress'inizde snippet'ler aracılığıyla yapılandırılmış yerel NGINX root veya alias yönergeleri olmadığından emin olun.

Yol eşleştirme mantığı değişiklikleri

Ön ek eşleştirme mantığı NGINX Ingress Controller sürümleri arasında farklılık gösterebilir, bu da iş yükü erişim sorunlarına neden olabilir.

  • Daha eski NGINX Ingress Controller sürümlerinde (v0.44 öncesi), ön ek eşleştirme daha esnektir. /aaa/bbb gibi bir yapılandırma, /aaa/bbbbb istek URL'sini eşleştirebilir.

  • Daha sonraki bir sürüme yükselttikten sonra, ön ek eşleştirme daha katı hale gelebilir ve yalnızca tam istek yolunu eşleştirebilir. Daha önce eşleşen /aaa/bbbbb gibi bir yol artık eşleşmeyebilir, bu da 404 hatasına neden olabilir.

Yol eşleştirme mantığı değişiklikleri örneği

  apiVersion: extensions/v1beta1
  kind: Ingress
  metadata:
    labels:
      ingress-controller: nginx
    name: test
    namespace: default
  spec:
    ingressClassName: nginx
    rules:
    - host: www.example.com
      http:
        paths:
        - backend:
            service:
              name: api-resources-svc
              port:
                number: 8080
          path: /api/resource

Yukarıdaki örnek Ingress kaynağı farklı sürümlerde farklı davranır:

  • Daha eski sürümlerdeki davranış

    v0.22.0.5-552e0db-aliyun gibi daha eski bir NGINX Ingress sürümünde, karşılık gelen NGINX yapılandırması şöyledir:

    Location /api/resource   ## No trailing "/"

    Yukarıdaki yapılandırmada, /api/resource yoluna daha eski NGINX sürümlerinde http://www.example.com/api/resource üzerinden erişilebilir.

    Not

    Gerçek erişim yolu resource s şeklindedir, resource değil.

  • Daha sonraki sürümlerdeki davranış

    NGINX Ingress Controller'ı v1.2.1-aliyun.1+ gibi daha sonraki bir sürüme yükseltirseniz, karşılık gelen NGINX yapılandırması şöyledir:

    Location /api/resource/  # Added a trailing "/"
    {
    }
    ...
    Location = /api/resource  # Added a Location for an exact match
    {
    }

    http://www.example.com/api/resources adresine erişim 404 hatası döndürür.

Etkilenen sürümler

v0.44 öncesi NGINX Ingress Controller sürümleri etkilenir. NGINX Ingress Controller sürüm geçmişi için bkz. NGINX Ingress controller. İlgili PR hakkında bilgi için bkz. kubernetes/ingress-nginx #6443.

Eklenti yükseltmesinden sonra Gzip varsayılan olarak devre dışı bırakılır

Varsayılan olarak etkinleştirilen özellikler sürümler arasında farklılık gösterebilir. Örneğin, gzip v0.40 öncesi NGINX Ingress Controller sürümlerinde varsayılan olarak etkinleştirilir, ancak daha sonraki sürümlerde varsayılan olarak devre dışı bırakılır. Eklenti güncellendikten sonra gzip kapatılır, bu da NGINX Ingress Controller ile ilişkili CLB'deki trafiği artırabilir. CLB örneği kullandıkça öde faturalama yöntemini kullanıyorsa, maliyetler artabilir.

Çözümler

kube-system ad alanında, nginx-configuration ConfigMap'ini düzenleyin ve gzip sıkıştırmayı manuel olarak etkinleştirin.

data:
  use-gzip: true

Doğrulama aşaması ayrıntıları

Eklenti ve iş yükü durumunu doğrulayın

Kendi iş yükü izleme yeteneklerinize ek olarak, ACK NGINX Ingress Controller'ın çalışma durumunu izlemek için SLS günlükleri, Managed Service for Prometheus panoları ve konteyner günlükleri sağlar. Bu hizmetleri etkinleştirmek için bkz. nginx-ingress-controller erişim günlüğünü analiz etme ve izleme ve Managed Service for Prometheus yapılandırma.

Simple Log Service (SLS)

ACK konsolunda SLS tarafından toplanan günlükleri görüntüleyin.

  1. ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde Operations > Log Center seçeneğine tıklayın.

  3. Application Logs sekmesine tıklayın. Logstore açılır listesinde nginx-ingress seçeneğini belirleyin ve ardından Select Logstore seçeneğine tıklayın.

    Not

    Logstore'unuz nginx-ingress girişi içermiyorsa, eklenti için günlük toplamanın yapılandırıldığını doğrulayın. Daha fazla bilgi için bkz. nginx-ingress-controller erişim günlüğünü analiz etme ve izleme.

Görüntülenen günlükler uygulama erişim günlüklerini içerir. Sorgu ifadesinde bir Pod belirtin, örneğin yeni eklenti sürümünün Pod'u, böylece yalnızca o Pod'un erişim günlüklerini görüntüleyebilirsiniz. Yeni Pod'un istek başarı oranının anormal olup olmadığını ve istek sayısının eski Pod ile eşleşip eşleşmediğini kontrol edin. Fark önemliyse, geri alabilirsiniz.

Not

Bir istek herhangi bir Ingress kuralıyla eşleşmediğinde ve 404 döndürdüğünde, varsayılan olarak bir erişim günlüğü kaydedilmez.

Managed Service for Prometheus panoları

Eklentinin genel istek durumunu gözlemlemek için Managed Service for Prometheus tarafından sağlanan panoları kullanın.

  1. ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde Operations > Prometheus Monitoring seçeneğine tıklayın.

  3. Network Monitoring sekmesine tıklayın ve ardından Ingresses seçeneğine tıklayın.

    Not

    İzlemede Ingresses kullanılamıyorsa, eklenti için Prometheus metrik toplamanın yapılandırıldığını doğrulayın. Daha fazla bilgi için bkz. Managed Service for Prometheus yapılandırma.

Panolar, Ingress'lerin operasyonel ölçümlerini gösterir. Metriklerini görüntülemek için bir Pod seçin. Benzer şekilde, yeni Pod'un istek başarı oranının anormal olup olmadığını ve istek sayısının eski Pod ile eşleşip eşleşmediğini kontrol edin. Fark önemliyse, geri alabilirsiniz.

Not

Varsayılan olarak, Host belirtilmemiş Ingress kuralları için (varsayılan joker karakter "*"dir) metrikler kaydedilmez.

Pod günlükleri

Hataları kontrol etmek için komut satırında kubectl kullanarak Pod günlüklerine erişin.

  • Pod'daki NGINX hata günlüklerini, warn, error ve crit düzeylerini dahil ederek görüntüleyin:

    kubectl logs -n kube-system <Pod-name> | grep -e warn -e error -e crit
  • Pod'daki denetleyici hata günlüklerini görüntüleyin:

    kubectl logs -n kube-system <Pod-name> | grep "^[EF]"

SSS

NGINX Ingress Controller belirli bir sürüme yükseltilebilir mi? Yükseltme başarılı olduktan sonra önceki bir sürüme geri alınabilir mi?

NGINX Ingress Controller belirli bir sürüme yükseltilemez. Eklenti, en son sürüme ulaşana kadar aşamalı olarak yükseltilir. Yükseltme başarılı olduktan sonra geri alınamaz.

Doğrulama veya yayınlama aşamasında Pod ölçeklendirmesi başarısız olursa ne yapmalıyım?


Neden


Çözümler


Yeni sürüm Pod'u başlatıldığında yapılandırma yükleme hatası gibi bir hata oluşur, bu da Pod'un çökme durumunda kalmasına neden olur.


Pod günlükleri bölümündeki yöntemleri kullanarak Pod'un hata günlüklerini görüntüleyin. Sorunu tespit etmek ve çözmek için bkz. NGINX Ingress sorunlarını giderme.


Bu durum genellikle NGINX Ingress Controller'ın özel düğümlere dağıtılması durumunda meydana gelir. Yeni bir Pod ölçeklendirildiğinde, yapılandırılan kaynak sınırları ve düğüm seçiciler yeni Pod'u zamanlamak için kullanılabilir bir düğüm bırakmayabilir.


Düğümleri geçici olarak ölçeklendirin veya NGINX Ingress Controller'ı yoğun olmayan saatlerde küçültüp ardından yükseltin, böylece Pods yükseltme sırasında beklendiği gibi zamanlanabilir.

Dağıtım şablonu ön kontrolü başarısız olursa ne yapmalıyım?

Dağıtım şablonunuz ön kontrolü başarısız olursa, eklenti farklılıkları sayfasını açmak ve kontrolü başarısız olan alanları görüntülemek için Cause of Error öğesinin sağındaki bağlantıya tıklayın.

  1. NGINX Ingress Controller add-on upgrade sayfasında, Precheck altında View Details seçeneğine tıklayın.

  2. Check Report sayfasında, Cluster Add-on Check Results bölümünde kontrol sonuçlarını görüntüleyin. Check Result sayfasında Deployment Template seçeneğine tıklayın ve ardından Cause of Error öğesinin sağındaki bağlantıya tıklayın.

  3. Kontrolü başarısız olan alanları görüntülemek için Add-on Differences sayfasını açın.

    Add-on Differences sayfası, o eklenti sürümü için standart şablonu (sol) ile kümenizdeki eklenti şablonunu (sağ) karşılaştırır. Sayfa, uyumlu ve uyumsuz alanlar dahil olmak üzere ikisi arasındaki tüm farklılıkları işaretler. Karşılaştırmanın altında, kümenizdeki eklentinin farklılık kontrolünü geçip geçmediğini gösterir ve uyumsuz alanların belirli yollarını listeler.

  4. Farklılık gösteren alanları değiştirin.

    Workloads > Deployments seçeneğini belirleyin, NGINX Ingress Controller eklentisini bulun ve More > View YAML seçeneğine tıklayın. Edit YAML sayfasında, args alanında --v=3 değerini --v=2 olarak değiştirin.

  5. Farklılık gösteren alanları değiştirdikten sonra, en son karşılaştırmayı görüntülemek için Add-on Differences sayfasını yeniden açabilir veya yenileyebilirsiniz. Sayfanın alt kısmında Add-on can pass the difference check gösterildiğinde, Dağıtım şablonu ön kontrolü başarılı olur.

    Not

    Kümedeki Dağıtımı değiştirirken NGINX Ingress Controller Pod'ları yeniden başlatılır, bu nedenle bu işlemi yoğun olmayan saatlerde gerçekleştirin.

Referanslar