Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Best practices for the NGINX Ingress controller

Son Güncelleme:Oct 06, 2026

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

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.

Önemli

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 Network > Ingresses yolunu izleyerek NGINX Ingress Overview sayfasındaki Log Service tabanlı panoyu görüntüleyebilirsiniz. Ayrıca Operations > Log Center 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 Operations > Prometheus Monitoring 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.

    Not

    Managed Service for Prometheus kullanırken, kümedeki Ingress kaynaklarına host alanını ekleyin. Aksi takdirde, Ingress için bazı ölçümler varsayılan olarak eksik olur. Alternatif olarak, NGINX Ingress controller Deployment içindeki controller öğesine --metrics-per-host=false baş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 olarak kube-system ad alanındaki nginx-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.

Önemli

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.