Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Configure NGINX Ingress controller for high loads

Son Güncelleme:Oct 06, 2026

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.

Önemli
  • 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.

Önemli

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-ingress ekleyin ve Effect değerini NoSchedule olarak 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.

  1. NodeSelector bölümünde, özel düğüm havuzunun etiketini ekleyin.

    Mevcut NodeSelector etiketlerini silmeyin.
  2. Tolerations bölümünde, özel düğüm havuzunun taint değerini ekleyin ve Effect değerini NoSchedule olarak ayarlayın.

  3. 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.

Önemli

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
 ...
preStop bekleme süresini maksimum yanıt sürenizin 1,5–2 katı olarak ayarlayın. sleep komutunun 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, Network > Ingresses 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 Operations > Log Center > Application Logs > Logstore 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 Operations > Prometheus Monitoring 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 bir host alanı ekleyin. host iç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ındaki controller bağımsız değişkenlerine --metrics-per-host=false ekleyin.

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.

  1. NGINX Ingress denetleyicisi kapsayıcısının çalıştığı düğüme oturum açın.

  2. /root dizininde nginx-log-rotate.sh dosyası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)"
    done

    Docker 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
  3. nginx-log-rotate.sh dosyasını yürütülebilir yapın.

    chmod 755 /root/nginx-log-rotate.sh
  4. Aşağıdakileri /etc/crontab dosyası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.

Önemli

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"

    İlgili nginx.conf yapılandırması

    Bu yapılandırmayı senaryonuza göre NGINX nginx.conf dosyasında ayarlayabilirsiniz.

    ssl_session_cache shared:SSL:10m; # 1 MB can store about 4,000 sessions.
    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 keepalive

keep-alive: "60s"

Bir downstream keepalive bağlantısının açık tutulacağı maksimum süre.

keep-alive-requests: "10000"

Maksimum downstream keepalive istek sayısı.

upstream keepalive

upstream-keepalive-connections: "1000"

Maksimum upstream keepalive bağlantı sayısı.

upstream-keepalive-requests: "2147483647"

Maksimum upstream keepalive istek sayısı.

upstream-keepalive-time: "1h"

Bir upstream keepalive bağlantısının açık tutulacağı maksimum süre.

upstream-keepalive-timeout: "150s"

Upstream keepalive bağlantıları için boşta kalma zaman aşımı.

Çalışan başına maksimum bağlantı

max-worker-connections: "65536"

Tek bir çalışan tarafından işlenebilecek maksimum bağlantı sayısı.

Zaman aşımı ayarları

Kullanım durumunuza göre ayarlayın.

proxy-connect-timeout: "3s"

TCP bağlantısı kurmak için zaman aşımı.

proxy-read-timeout: "5s"

Veri okuma zaman aşımı.

proxy-send-timeout: "5s"

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.

proxy-next-upstream-tries: "3"

Başarısızlık sonrası yeniden deneme sayısı. Varsayılan: 3 (bir ilk deneme + iki yeniden deneme).

proxy-next-upstream: "off"

Yeniden deneme koşulları. Yeniden denemeleri devre dışı bırakmak için off olarak ayarlayın.

proxy-next-upstream-timeout: "5s"

İ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.