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.
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.
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
LoadBalancerhizmetinin sağlıklı olduğunu (varsayılan adnginx-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
ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde Components and Add-ons seçeneğine tıklayın.
Add-ons sayfasında, NGINX Ingress Controller eklentisini bulun ve eklentinin sağ alt köşesindeki Upgrade seçeneğine tıklayın.
-
Görüntülenen yükseltme panelinde, yükseltmeyi başlatmak için Start seçeneğine tıklayın ve onaylayın.
NotYü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.
-
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.
-
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.
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.
-
Eklenti ve iş yükü durumunda anormallik olmadığını onayladıktan sonra, yükseltmeyi tamamlamak için Continue seçeneğine tıklayın.
NotYü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 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 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.
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:
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-levelvarsayılan düzeyiCriticaldeğerindenHighdeğerine düşürülmüştür. Bu değişiklik, kümedekiIngresskaynaklarında bulunan mevcutCriticaldüzeyi Ek Açıklamaların (Annotations), örneğinsnippetile ilgili Ek Açıklamaların, kullanılamaz hale gelmesine neden olur.allow-cross-namespace-resourcesdeğeritruedeğerindenfalsedeğerine değiştirilmiştir. Varsayılan olarak, bu yapılandırmaConfigMapveSecretsgibi kaynaklara ad alanları arası başvuruları yasaklar.strict-validate-path-typedeğerifalsedeğerindentruedeğerine değiştirilmiştir. Bu yapılandırma, varsayılan olarak sıkı yol adresi doğrulamasını etkinleştirir. Bu,ExactvePrefixtü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-targetEk Açıklamasının kullanımını değiştirdi. 0.22.0 ve sonraki sürümlerde,rewrite-targetkullanı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-targetEk Açıklaması yerineconfiguration-snippetkullanabilirsiniz.
Örneğin, 0.22.0 öncesi sürümlerde kural şöyledir:
Şu şekilde değiştirin:
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.
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/bbbgibi bir yapılandırma,/aaa/bbbbbistek 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/bbbbbgibi bir yol artık eşleşmeyebilir, bu da 404 hatasına neden olabilir.
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.
ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde seçeneğine tıklayın.
-
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.
NotLogstore'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.
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.
ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde seçeneğine tıklayın.
-
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.
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?
|
|
|
|
|
|
|
|
|
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.
NGINX Ingress Controller add-on upgrade sayfasında, Precheck altında View Details seçeneğine tıklayın.
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.
-
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.
-
Farklılık gösteren alanları değiştirin.
seçeneğini belirleyin, NGINX Ingress Controller eklentisini bulun ve seçeneğine tıklayın. Edit YAML sayfasında, args alanında
--v=3değerini--v=2olarak değiştirin. -
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.
NotKü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
NGINX Ingress Controller eklentisinin değişiklik günlüğü için bkz. NGINX Ingress controller.
NGINX Ingress Controller eklentisinde ağ bağlantısı hataları gibi sorunlar varsa, önce belgeleri kontrol edin. Daha fazla bilgi için bkz. Küme güvenlik gruplarını yapılandırma ve NGINX ingress SSS.