Bu konu, çeşitli senaryolarda optimum performans sağlamak amacıyla NGINX Ingress controller yapılandırmasına ilişkin en iyi uygulamaları açıklar.
Bu konudaki başlıklar
NGINX Ingress controller performansı ve kararlılığı
Uygun kopya sayısı ve kaynak sınırları
Küme oluşturma sırasında veya Eklentiler sayfasından yüklenen varsayılan NGINX Ingress controller iki kopyaya sahiptir. İş gereksinimlerinize göre bu sayıyı ayarlayabilirsiniz. Kaynak çekişmesini ve tek nokta arızalarını önlemek için NGINX Ingress controller podlarının farklı düğümlere dağıtıldığından emin olun. Performans ve kararlılığı garanti altına almak için özel düğümler de atayabilirsiniz. Daha fazla bilgi için bkz. NGINX Ingress performansını ve kararlılığını artırmak için özel düğümler kullanın. Bellek yetersizliği (OOM) olaylarından kaynaklanan trafik kesintilerini önlemek amacıyla NGINX Ingress controller için kaynak sınırı belirlemeyin. Sınır belirlemeniz gerekirse CPU sınırını en az 1.000 milicore, bellek sınırını ise en az 2 GiB olarak ayarlayın.
Özel düğümler kullanma
Yüksek kararlılık gereksinimleri için, kaynak çekişmesini önlemek amacıyla Ingress controller'a özel düğümler atayın. Daha fazla bilgi için bkz. Yüksek kullanılabilirliğe sahip NGINX Ingress controller dağıtma.
Yüksek yük senaryoları için Ingress controller'ı yüksek trafikli uygulamaları destekleyecek şekilde de yapılandırabilirsiniz. Daha fazla bilgi için bkz. Yüksek yük senaryoları için NGINX Ingress controller yapılandırma.
NGINX Ingress performansını optimize etme
NGINX Ingress controller için performans ayarlama iki ana alanı kapsar: sistem parametreleri ayarlama ve NGINX parametreleri ayarlama.
Sistem parametreleri ayarlama: Alibaba Cloud işletim sistemleri, yaygın parametreler için varsayılan optimizasyonlar içerir. Ayarlamanız gerekebilecek diğer sistem parametreleri arasında maksimum sistem geri kuyruğu ve kullanılabilir bağlantı noktası aralığı yer alır. Sistem parametrelerini ayarlamak, NGINX'in yüksek eşzamanlılığı yönetebilmesini sağlar ve bağlantı noktası tükenmesi nedeniyle arka uçlara bağlantı hatalarını önler.
-
NGINX parametreleri ayarlama:
Her çalışan işlem başına maksimum bağlantı sayısını ayarlamak, NGINX Ingress controller'ın yüksek eşzamanlılığı yönetebilmesini sağlar.
Bağlantı zaman aşımını artırın: Varsayılan NGINX davranışının aksine, NGINX Ingress controller arka uç podlarına istek göndermek için keep-alive bağlantıları kullanır. Bu nedenle, yeni bağlantı oluşturma ek yükünü azaltmak ve tek bir bağlantının daha fazla isteği işleyebilmesine olanak tanımak için bağlantı zaman aşımını artırın.
Keep-alive zaman aşımını ayarlayın: Arka uç hizmetleri için keep-alive zaman aşımını, ACK kümelerinde varsayılan olarak 900 saniye olan NGINX Ingress controller bağlantı zaman aşımına eşit veya ondan büyük olacak şekilde ayarlayın.
NGINX Ingress bileşeni, çoğu senaryoda optimum performans sağlayan varsayılan ayar parametrelerini içerir. Özel gereksinimleriniz varsa, ConfigMap içindeki ilgili alanları kullanarak sistem ve NGINX parametrelerini daha da optimize edebilirsiniz. ConfigMap hakkında daha fazla bilgi için bkz. ConfigMaps.
HPA ile otomatik ölçeklendirme
Çoğu durumda NGINX Ingress controller ani trafik artışlarını yönetebilir. Varsayılan kapasite yüksek yük senaryolarınız için yetersiz kalırsa, NGINX Ingress controller'ı otomatik olarak ölçeklendirmek üzere Yatay Pod Otomatik Ölçeklendirici (HPA) yapılandırın. Daha fazla bilgi için bkz. Yatay Pod Otomatik Ölçeklendirici (HPA) kullanma.
Pod ölçeklendirme olayları mevcut bağlantıları geçici olarak kesintiye uğratabilir. Bu özelliği dikkatli bir şekilde yapılandırın.
Aşağıda örnek bir YAML yapılandırması verilmiştir:
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
name: nginx-ingress-controller-hpa
namespace: kube-system
spec:
scaleTargetRef:
apiVersion: apps/v1
kind: Deployment
name: nginx-ingress-controller
minReplicas: 2
maxReplicas: 5
metrics:
- type: Resource
resource:
name: cpu
target:
type: Utilization
averageUtilization: 50
preStop hook yapılandırma
Bir arka uç hizmetinin ardışık güncellemesi sırasında, NGINX Ingress controller devam eden istekler için bağlantıları korurken sonlandırılan bir podun uç noktasını kaldırır. Bir arka uç hizmet podu, sonlandırma sinyalini aldıktan hemen sonra çıkarsa devam eden istekler başarısız olabilir. Zamanlama sorunları nedeniyle bazı yeni trafikler sonlandırılmış poda yönlendirilebilir ve bu durum trafik kaybına neden olur.
Ardışık güncellemeler sırasında trafik kaybını önlemek için arka uç hizmet podlarınızda bir preStop hook yapılandırın. Bu hook, uç noktası kaldırıldıktan sonra podun devam eden istekleri işlemeye devam etmesine olanak tanır ve hizmet kesintilerini önler.
Pod şablonundaki konteyner yapılandırmasına aşağıdaki kodu ekleyin:
apiVersion: apps/v1
kind: Deployment
spec:
template:
spec:
containers:
- name: app
lifecycle:
# Configure a preStop hook to wait for 30 seconds before exiting.
# The sleep command must be available in the container.
preStop:
exec:
command:
- sleep
- "30"
NGINX Ingress controller gözlemlenebilirliği
Log Service ve Managed Service for Prometheus
NGINX Ingress controller, hizmet trafiğinizi daha iyi anlamanıza yardımcı olmak için Log Service (SLS) günlüklerine ve Prometheus'a dayalı izleme panoları sağlar.
-
Log Service (SLS) günlükleri:
Küme oluştururken Log Service'i Etkinleştir ve Ingress Panosu Oluştur seçeneklerini belirlerseniz ACK konsolu adresine gidip yolunu izleyerek NGINX Ingress Overview sayfasındaki Log Service tabanlı panoyu görüntüleyebilirsiniz. Ayrıca yolunu izleyerek NGINX Ingress controller tarafından oluşturulan günlükleri görüntüleyebilirsiniz. Daha fazla bilgi için bkz. NGINX Ingress erişim günlüklerini toplama ve analiz etme.
Küme oluşturma sırasında bu seçenekleri etkinleştirmediyseniz günlük toplama bileşenini ve kurallarını manuel olarak yapılandırabilirsiniz. Daha fazla bilgi için bkz. NGINX Ingress erişim günlüklerini toplama ve analiz etme. İzleme hakkında daha fazla bilgi için bkz. Ingress pano izleme.
-
Managed Service for Prometheus izleme: Küme oluştururken Managed Service for Prometheus izlemeyi yüklemeyi seçebilirsiniz. Alternatif olarak, kümeyi oluşturduktan sonra yolunu izleyerek yükleyebilir veya görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Managed Service for Prometheus bağlama ve yapılandırma.
NotManaged Service for Prometheus kullanırken, kümedeki Ingress kaynaklarına
hostalanını ekleyin. Aksi takdirde, Ingress için bazı ölçümler varsayılan olarak eksik olur. Alternatif olarak, NGINX Ingress controller Deployment içindekicontrolleröğesine--metrics-per-host=falsebaşlatma bağımsız değişkenini ekleyin.
NGINX Ingress controller gelişmiş özellikleri
Birden fazla NGINX Ingress controller kullanma
Örneğin, iç ve dış trafiği yalıtmak için bir kümeye birden fazla NGINX Ingress controller dağıtmanız gerekebilir. Daha fazla bilgi için bkz. Trafik yalıtımı için birden fazla Ingress controller dağıtma.
Küme içi erişim
Bir kümede, LoadBalancer Hizmetinin dış uç noktasına (NGINX Ingress controller'ın genel IP adresi) yönelik trafik genellikle iptables veya IPVS tarafından engellenir ve iletilir. externalTrafficPolicy değeri Local olarak ayarlandığında ve bir düğümde çalışan NGINX Ingress pod'u olmadığında ağ bağlantısı sorunları ortaya çıkar. ACK kümesindeki NGINX Ingress controller varsayılan olarak Local modunda bir LoadBalancer Hizmeti kullanır. Bu nedenle, ilişkili Classic Load Balancer (CLB) adresine küme içinden erişirken bağlantı sorunları yaşayabilirsiniz. Küme içi erişim için Hizmetin ClusterIP'sini veya dahili etki alanı adını (nginx-ingress-lb.kube-system) kullanın. Ayrıca, NGINX Ingress controller'ın kendisine erişmeye çalıştığı ve hairpinning sorunları nedeniyle ağ arızalarına yol açabilecek senaryolardan kaçının. Bu sorunun nasıl çözüleceği hakkında daha fazla bilgi için bkz. Kubernetes kümesi içinden LoadBalancer Hizmetinin SLB örneğine erişilemiyor.
WAF kullanma
Kötü amaçlı istekleri engellemek için kümenizin NGINX Ingress controller tarafından kullanılan Classic Load Balancer (CLB) için Web Application Firewall (WAF) etkinleştirebilirsiniz. HTTPS bağlantı noktasında WAF etkinleştirdiğinizde gerekli sertifikayı WAF konsolunda da yapılandırmanız gerekir. Bu durum aşağıdaki sorunlara yol açabilir:
TLS istekleri WAF katmanında sonlandırılır. Bu nedenle, Kubernetes Secret içinde yapılandırılan sertifikalar genel uç nokta için kullanılmaz.
Küme içinden CLB IP adresini veya Hizmetin ClusterIP'sini kullanarak 443 numaralı bağlantı noktasına eriştiğinizde trafik WAF üzerinden geçmeyebilir ve bu durum sertifika hatalarına neden olur.
-
WAF etkinleştirildiğinde, NGINX Ingress controller varsayılan olarak gerçek istemci IP adresini alamaz. NGINX'in Realip modülünü etkinleştirmek ve gerçek istemci IP adresini almak için
X-Forwarded-Forüst bilgisini kullanmak üzere ConfigMap'e (bileşen yönetimi aracılığıyla yüklenen NGINX Ingress controller'lar için varsayılan olarakkube-systemad alanındakinginx-configuration) aşağıdaki içeriği ekleyin.use-forwarded-headers: "true" # Use this option for NGINX Ingress controller version 0.30.0 and earlier. enable-real-ip: "true" # Use this option for NGINX Ingress controller version 0.44.0 and later. proxy-real-ip-cidr: <The back-to-origin CIDR block that you obtain from WAF>
Mavi-yeşil dağıtımlar veya canary sürümleri
ACK konsolu içindeki özelliği kullanarak veya manuel olarak bir açıklama ekleyerek NGINX Ingress controller ile canary sürümü uygulayabilirsiniz. Daha fazla bilgi için bkz. Canary sürümleri ve mavi-yeşil dağıtımları uygulamak için NGINX Ingress kullanma.
Orijinal ve canary Hizmetleri yalnızca canary Ingress tarafından referans alınmalıdır. Aksi takdirde canary kuralı çakışmaları oluşabilir ve bu durum trafik yönlendirme hatalarına yol açabilir.
HTTP dışı istekleri proxy'leme
NGINX Ingress controller varsayılan olarak arka uç Hizmetlerine HTTP protokolünü kullanarak bağlanır. Ancak, en yaygın olanlar WebSocket, HTTPS ve gRPC olmak üzere birden fazla arka uç protokolünü destekler. Desteklenen arka uç protokollerinin tam listesi için bkz. Backend Protocol.
WebSocket: NGINX Ingress controller, WebSocket için yerel destek sağlar. WebSocket bağlantılarını iletmek için ek yapılandırma gerekmez. Uzun ömürlü WebSocket bağlantılarınız varsa, zaman aşımı kaynaklı bağlantı kopmalarını önlemek için arka uç bağlantı zaman aşımını ayarlamak üzere bir açıklama kullanabilirsiniz. Ayarlama yapma hakkında daha fazla bilgi için bkz. Custom timeouts.
HTTPS: HTTPS kullanan arka uç Hizmetleri için, HTTPS bağlantılarına geçiş yapmak amacıyla Ingress'e
nginx.ingress.kubernetes.io/backend-protocol:"HTTPS"açıklamasını ekleyebilirsiniz.gRPC: gRPC'ye yalnızca TLS bağlantı noktaları üzerinden erişilebilir. Bu nedenle, uygulamanız NGINX Ingress controller aracılığıyla gRPC hizmetlerine erişirken şifreli bir TLS bağlantı noktası kullandığınızdan emin olun. gRPC yapılandırma hakkında daha fazla bilgi için bkz. NGINX Ingress için gRPC hizmeti yapılandırma.