Tepe trafik seviyelerini karşılayabilmek için özel düğümler tahsis edin, otomatik ölçeklendirmeyi yapılandırın ve NGINX parametrelerini ince ayar yapın.
Açık kaynaklı Ingress NGINX projesinin Mart 2026'dan sonra bakımı yapılmayacağından, Container Service for Kubernetes NGINX Ingress denetleyicisi bileşeni bakımını sonlandıracaktır. İlişkili risklerin farkında olun. Bkz. Ürün duyurusu: NGINX Ingress denetleyicisi bileşeni bakımının sonlandırılması.
Aşağıdaki yapılandırmalar yalnızca referans amaçlıdır. Parametreleri ve teknik özellikleri gerçek NGINX Ingress denetleyicisi yükünüze göre seçin.
Bileşen kaynaklarının yeterli olduğundan emin olun
Özel bir düğüm havuzunda dağıtım yapın
Özel bir düğüm havuzu, NGINX Ingress denetleyicisini diğer iş yüklerinden izole ederek kaynak çekişmesini önler.
NGINX Ingress denetleyicisi kapsayıcıları için resources.limits ayarlamak, bellek kısıtlamaları nedeniyle OOM hatalarını tetikleyebilir veya CPU kısıtlamasından kaynaklanan hizmet kesintilerine ve titremeye neden olabilir. Kaynak sınırlarını yapılandırmayın. Yapmanız gerekirse, CPU'yu en az 1 çekirdeğe ve belleği en az 2 GiB'ye ayarlayın.
Özel bir düğüm havuzu oluşturun
NGINX Ingress denetleyicisi kapsayıcıları için bir özel düğüm havuzu oluşturun. Aşağıdaki noktalara dikkat edin:
Bir örnek türü seçin: Kapsayıcı ağ performansı, ana bilgisayar düğümünün örnek türü ile sınırlıdır. Örneğin, bir düğümün PPS değeri 300.000 ise, kapsayıcı başına maksimum PPS değeri de 300.000'dir. 32 veya daha fazla CPU çekirdeğine sahip ağ açısından optimize edilmiş bir örnek seçin.
Düğüm sayısı: NGINX Ingress denetleyicisi varsayılan olarak anti-afinite ile iki kapsayıcı dağıtır, bu nedenle düğüm havuzunda en az iki düğüm bulunmalıdır.
Taint ve etiketleri yapılandırın: Diğer kapsayıcıların bu düğümlere zamanlanmasını önlemek için taint ve etiketler ekleyin. Örneğin, hem taint hem de etiket olarak
system-addon: nginx-ingressekleyin ve Effect değeriniNoScheduleolarak ayarlayın.Bir kapsayıcı boyutu seçin: NGINX temel ek yükü nedeniyle, aynı toplam kaynağa sahip birden fazla düşük özellikli kapsayıcıya (örneğin, iki adet 16 çekirdekli kapsayıcı) kıyasla tek bir yüksek özellikli kapsayıcı (örneğin, 32 çekirdek) daha iyi performans gösterir. Yüksek kullanılabilirliği korurken daha az sayıda yüksek özellikli kapsayıcıyı tercih edin.
Bileşeni yapılandırın
ACK konsolu üzerinde oturum açın. Add-ons sayfasında NGINX Ingress denetleyicisi kartını bulun ve Configuration seçeneğine tıklayın.
-
NodeSelector bölümünde, özel düğüm havuzunun etiketini ekleyin.
Mevcut NodeSelector etiketlerini silmeyin.
Tolerations bölümünde, özel düğüm havuzunun taint değerini ekleyin ve Effect değerini NoSchedule olarak ayarlayın.
Confirm seçeneğine tıklayın, ardından kapsayıcıların özel düğüm havuzuna zamanlandığını doğrulayın.
CLB örneği teknik özelliklerini ayarlayın
CLB örneği teknik özellikleri, NGINX Ingress denetleyicisi için maksimum bağlantı sayısını ve QPS değerini belirler. Yüksek özellikli bir örnek kullanın.
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec ek açıklamasıyla CLB örneği teknik özelliklerini belirtmek için Hizmeti düzenleyin:
kubectl edit service -n kube-system nginx-ingress-lb
apiVersion: v1
kind: Service
metadata:
annotations:
...
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: "slb.s3.large" # Specify the CLB instance specification
name: nginx-ingress-lb
namespace: kube-system
...
spec:
...
Bu işlem yalnızca Haziran 2025'ten önce oluşturulan, spesifikasyona göre ücretlendirilen CLB örneklerinde desteklenir. Bkz. Performans teknik özellikleri .
Otomatik ölçeklendirme için HPA kullanın
Özel düğüm havuzu kapsayıcıları trafik dalgalanmalarını karşılayamıyorsa, NGINX Ingress denetleyicisini otomatik olarak ölçeklendirmek için HPA'yı yapılandırın.
Kapsayıcıların ölçeğinin küçültülmesi bazı aktif bağlantıları kesebilir. Ölçek küçültme ilkenizi dikkatle yapılandırın.
Aşağıdakileri nginx-hpa.yaml olarak kaydedin ve kubectl apply -f nginx-hpa.yaml komutuyla uygulayın:
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
Arka plan iş yükleri için sorunsuz kapatmayı sağlayın
Aşamalı güncellemeler sırasında, NGINX Ingress denetleyicisi sonlandırılan kapsayıcılara giden devam eden bağlantıları korur. Bir kapsayıcı hemen çıkarsa bu istekler başarısız olur.
Bir preStop hook'u, SIGTERM sonrası kapsayıcının çalışmaya devam etmesini sağlayarak devam eden isteklerin tamamlanmasına olanak tanır:
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 exist in the container.
preStop:
exec:
command:
- sleep
- 30
...
preStopbekleme süresini maksimum yanıt sürenizin 1,5–2 katı olarak ayarlayın.sleepkomutunun kapsayıcı görüntüsünde mevcut olduğundan emin olun.
Ölçümler ve günlüklerle bileşen durumunu izleyin
SLS günlükleri
ACK konsolu üzerinde, sayfasındaki NGINX Ingress Overview sekmesine gidin. Burada, istemci erişim verilerini kontrol etmek için günlük panosunu görüntüleyebilirsiniz. Ayrıca yolunu izleyip nginx-ingress seçeneğini belirterek belirli günlük girişlerini görüntüleyebilirsiniz.
Günlük panosu null veri noktaları gösteriyorsa veya Logstore içindeki nginx-ingress günlükleri boşsa, küme oluşturma sırasında günlük kaydı etkinleştirilmemiş demektir. Bkz. NGINX Ingress erişim günlüklerini toplama ve analiz etme.
Prometheus izleme
ACK konsolu üzerinde oturum açın ve izleme panosunu görüntülemek için yolunu izleyin.
Bir bileşen yüklü değilse, yükleme istemlerini takip edin ve panoyu kontrol edin.
Ingresses sekmesini seçin. Controller Class açılır menüsünde, NGINX Ingress ölçümlerini görüntülemek için k8s.io/ingress-nginx seçeneğini belirleyin. k8s.io/ingress-nginx listede yoksa, NGINX Ingress denetleyicisi yüklü değildir.
Ingress kaynaklarınıza birhostalanı ekleyin.hostiçermeyen kaynaklar için varsayılan olarak ölçüm toplama yapılmaz. Ana bilgisayar başına izlemeyi atlamak için, NGINX Ingress Dağıtımındakicontrollerbağımsız değişkenlerine--metrics-per-host=falseekleyin.
NGINX yapılandırmasını optimize edin
Otomatik günlük döndürmeyi yapılandırın
NGINX Ingress denetleyicisi kapsayıcıları günlükleri hem /dev/stdout hem de /var/log/nginx/ konumuna yazar. Günlük dosyaları büyüdükçe, yeni girişler yazmak daha fazla kaynak tüketir. Otomatik döndürme, günlükleri periyodik olarak arşivleyip temizleyerek bu durumu hafifletir.
NGINX Ingress denetleyicisi kapsayıcısının çalıştığı düğüme oturum açın.
-
/rootdizinindenginx-log-rotate.shdosyasını oluşturun.Containerd node
#!/bin/bash # The maximum number of log files to keep. Adjust as needed. keep_log_num=5 # Get the IDs of all running ingress-nginx containers. ingress_nginx_container_ids=$(crictl ps | grep nginx-ingress-controller | grep -v pause | awk '{print $1}') if [[ -z "$ingress_nginx_container_ids" ]]; then echo "error: failed to get ingress nginx container ids" exit 1 fi # Sleep for a random interval between 5 and 10 seconds. sleep $(( RANDOM % (10 - 5 + 1 ) + 5 )) for id in $ingress_nginx_container_ids; do crictl exec $id bash -c "cd /var/log/nginx; if [[ \$(ls access.log-* | wc -l) -gt $keep_log_num ]]; then rm -f \$(ls -t access.log-* | tail -1); fi ; mv access.log access.log-\$(date +%F:%T) ; kill -USR1 \$(cat /tmp/nginx/nginx.pid)" doneDocker node
#!/bin/bash # The maximum number of log files to keep. Adjust as needed. keep_log_num=5 # Get the IDs of all running ingress-nginx containers. ingress_nginx_container_ids=$(docker ps | grep nginx-ingress-controller | grep -v pause | awk '{print $1}') if [[ -z "$ingress_nginx_container_ids" ]]; then echo "error: failed to get ingress nginx container ids" exit 1 fi # Sleep for a random interval between 5 and 10 seconds. sleep $(( RANDOM % (10 - 5 + 1 ) + 5 )) for id in $ingress_nginx_container_ids; do docker exec $id bash -c "cd /var/log/nginx; if [[ \$(ls access.log-* | wc -l) -gt $keep_log_num ]]; then rm -f \$(ls -t access.log-* | tail -1); fi ; mv access.log access.log-\$(date +%F:%T) ; kill -USR1 \$(cat /tmp/nginx/nginx.pid)" done -
nginx-log-rotate.shdosyasını yürütülebilir yapın.chmod 755 /root/nginx-log-rotate.sh -
Aşağıdakileri
/etc/crontabdosyasına ekleyin:Bu işlem günlükleri her 15 dakikada bir döndürür. Zamanlamayı ihtiyacınıza göre ayarlayın.
*/15 * * * * root /root/nginx-log-rotate.sh
Ölçüm toplamayı devre dışı bırakın
Ölçüm toplama varsayılan olarak etkindir ve CPU tüketir. Ölçümlere ihtiyacınız yoksa bunu devre dışı bırakın.
Denetleyici Dağıtımını düzenleyin (kubectl edit deploy nginx-ingress-controller -n kube-system). Ölçümleri devre dışı bırakmak için kapsayıcı bağımsız değişkenlerine --enable-metrics=false ekleyin.
v1.9.3 or earlier
spec:
containers:
- args:
- ...
- --enable-metrics=false
Versions later than v1.9.3
v1.9.3'ten sonraki NGINX Ingress denetleyicisi sürümleri, belirli ölçümlerin devre dışı bırakılmasına olanak tanır. Örneğin, soketle ilgili ölçümlerin toplanmasını durdurmak için --exclude-socket-metrics ekleyin. Bkz. cli-arguments.
spec:
containers:
- args:
- ...
- --enable-metrics=true
- --exclude-socket-metrics # Effective only when --enable-metrics=true
Brotli sıkıştırmayı etkinleştirin
Brotli algoritması genellikle metin tabanlı web kaynakları için gzip'e kıyasla %15–%30 daha iyi sıkıştırma sağlar.
Gerçek iyileştirme senaryonuza bağlıdır.
Brotli sıkıştırmayı etkinleştirmek için NGINX Ingress ConfigMap'i düzenleyin (kubectl edit cm -n kube-system nginx-configuration).
data:
enable-brotli: "true"
brotli-level: "6"
brotli-types: "text/xml image/svg+xml application/x-font-ttf image/vnd.microsoft.icon application/x-font-opentype application/json font/eot application/vnd.ms-fontobject application/javascript font/otf application/xml application/xhtml+xml text/javascript application/x-javascript text/plain application/x-font-truetype application/xml+rss image/x-icon font/opentype text/css image/x-win-bitmap"
enable-brotli: Brotli'nin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:true,false.brotli-level: Sıkıştırma düzeyi. Geçerli değerler: 1–11. Varsayılan: 4. Daha yüksek değerler daha fazla CPU tüketir.brotli-types: Brotli ile sıkıştırılacak MIME türleri.
Zaman aşımı ilkesini ayarlayın
FIN_WAIT2 ve TIME_WAIT zaman aşımlarını azaltmak, NGINX Ingress denetleyicisinin tamamlanmış bağlantıları daha hızlı geri kazanmasını ve kaynakları serbest bırakmasını sağlar.
FIN_WAIT2 ve TIME_WAIT parametreleri, NGINX Ingress denetleyicisi bağlantı geri dönüşünü doğrudan etkiler. Yanlış ayarlar, yüksek eşzamanlılık altında bağlantı havuzu tükenmesine, bağlantı noktası azalmasına veya tıkanıklığa neden olabilir. Ayarlama yapmadan önce TCP bağlantı ilkelerini anladığınızdan emin olun. Değişiklikten sonra bağlantı durumunu ve kaynak kullanımını sürekli olarak izleyin.
NGINX Ingress denetleyicisi Dağıtımını düzenleyin (kubectl edit deploy nginx-ingress-controller -n kube-system).
Aşağıdakileri initContainers bölümüne ekleyin:
net.ipv4.tcp_fin_timeout: FIN_WAIT2 zaman aşımı. Varsayılan: 60 saniye.net.netfilter.nf_conntrack_tcp_timeout_time_wait: TIME_WAIT zaman aşımı. Varsayılan: 60 saniye.
dnsPolicy: ...
initContainers:
- command:
- /bin/sh
- -c
- |
if [ "$POD_IP" != "$HOST_IP" ]; then
mount -o remount rw /proc/sys
sysctl -w net.core.somaxconn=65535
sysctl -w net.ipv4.ip_local_port_range="1024 65535"
sysctl -w kernel.core_uses_pid=0
sysctl -w net.ipv4.tcp_fin_timeout=15 # Set the timeout for the FIN_WAIT2 state to 15 seconds
sysctl -w net.netfilter.nf_conntrack_tcp_timeout_time_wait=30 # Set the timeout for the TIME_WAIT state to 30 seconds
fi
env:
...
image: ...
imagePullPolicy: IfNotPresent
name: init-sysctl
HTTPS performansını optimize edin
nginx-configuration ConfigMap'indeki aşağıdaki parametreleri ayarlayın.
kubectl edit cm -n kube-system nginx-configuration
-
SSL oturum önbelleği ve zaman aşımı
SSL oturum önbelleği boyutunu ve zaman aşımını ayarlamak el sıkışma ek yükünü azaltır.
data: ssl-session-cache-size: "10m" ssl-session-timeout: "10m" -
Sertifika doğrulama süresini azaltmak için OCSP stapling'i etkinleştirin.
data: enable-ocsp: "true" -
İstemcilerin el sıkışma tamamlanmadan önce veri göndermesine olanak tanıyarak bağlantı kurulum gecikmesini azaltmak için TLS 1.3 0-RTT'yi etkinleştirin.
data: ssl-early-data: "true" ssl-protocols: "TLSv1.3" -
Şifre önceliğini ayarlayın (manuel ayar gerekmez)
Şifre paketi önceliği gecikmeyi etkiler. NGINX Ingress denetleyicisi varsayılanı zaten optimize edilmiştir.
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384'; ssl_prefer_server_ciphers on; # Prioritize the server's cipher configuration.
Diğer performansla ilgili seçenekleri yapılandırın
Aşağıdaki nginx-configuration ConfigMap seçenekleri de performansı etkiler. Düzenlemek için kubectl edit cm -n kube-system nginx-configuration komutunu çalıştırın.
|
Kategori |
Parametre |
Açıklama |
|
downstream |
|
Bir downstream |
|
|
Maksimum downstream |
|
|
upstream |
|
Maksimum upstream |
|
|
Maksimum upstream |
|
|
|
Bir upstream |
|
|
|
Upstream |
|
|
Çalışan başına maksimum bağlantı |
|
Tek bir çalışan tarafından işlenebilecek maksimum bağlantı sayısı. |
|
Zaman aşımı ayarları Kullanım durumunuza göre ayarlayın. |
|
TCP bağlantısı kurmak için zaman aşımı. |
|
|
Veri okuma zaman aşımı. |
|
|
|
Veri gönderme zaman aşımı. |
|
|
Yeniden deneme mekanizması Aşırı yeniden denemeler arka plan yükünü artırabilir ve hizmetler kararsız olduğunda kademeli arızalara neden olabilir. Bkz. Ingress-nginx resmi belgeleri. |
|
Başarısızlık sonrası yeniden deneme sayısı. Varsayılan: 3 (bir ilk deneme + iki yeniden deneme). |
|
|
Yeniden deneme koşulları. Yeniden denemeleri devre dışı bırakmak için |
|
|
|
İstek yeniden denemeleri için zaman aşımı. Senaryonuza göre ayarlayın. |
Referanslar
CNI eklentisi, NGINX Ingress denetleyicisini etkileyen küme ağ performansını etkiler. Terway ağ eklentisini kullanmanızı öneririz.