Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Scale multiple applications with NGINX Ingress traffic metrics

Son Güncelleme:Oct 30, 2026

Çoklu örnek dağıtımı uygulama kararlılığını artırır ancak kaynakların boşta kalmasına ve küme maliyetlerinin artmasına neden olabilir. Manuel ölçeklendirme emek yoğundur ve yanıt verme süresi uzundur. Nginx Ingress kullanarak birden çok uygulamada yatay pod otomatik ölçeklendirmesi (HPA) uygulayabilirsiniz; bu sayede yük dinamik olarak ayarlanır, Pod çoğaltma sayısı değiştirilir, kararlılık ve yanıt verebilirlik korunurken kaynak kullanımı ve maliyet optimize edilir. Bu konuda Nginx Ingress ile çoklu uygulama HPA'sının nasıl uygulanacağı açıklanmaktadır.

Ön koşullar

Aşağıdakilerin mevcut olduğundan emin olun:

  • Alibaba Cloud Prometheus kümenizde dağıtılmıştır.

  • prometheus.url yapılandırılmış olarak ack-alibaba-cloud-metrics-adapter add-on dağıtılmıştır.

    prometheus.url nasıl yapılandırılır

    1. ACK console üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

    2. Clusters sayfasında istediğiniz kümeyi bulun ve adına tıklayın. Sol bölmede Applications > Helm seçeneklerini belirleyin.

    3. Helm sayfasında ack-alibaba-cloud-metrics-adapter öğesini bulun ve Actions sütunundaki Update seçeneğine tıklayın.

    4. Update Release panelinde alibabaCloudMetricsAdapter.prometheus.url değerini Prometheus veri istek URL'nize ayarlayın, ardından OK seçeneğine tıklayın.

    Bkz. Prometheus veri istek URL'si nasıl alınır ve ack-alibaba-cloud-metrics-adapter yapılandırma referansı .
  • Apache Benchmark (ab) yüklüdür.

    Örnek komutlar

    İşletim sistemi paket yöneticinizle ab'yi yükleyin:

    • macOS (Homebrew): bash brew install httpd

    • Windows: Windows yapısını Apache Lounge adresinden indirin. Arşivi çıkarın, bin klasörüne gidin ve ab.exe dosyasını çalıştırın.

    • Ubuntu veya Debian: shell sudo apt update sudo apt install apache2-utils

    • CentOS 8 veya RHEL: shell sudo yum install httpd-tools

    Yüklemeyi doğrulayın:

    ab -V

Çalışma mekanizması

Bir Ingress, harici istekleri eşleşen pod'a yönlendiren bir Service'e iletir. NGINX Ingress Controller, hizmet başına istek sayılarını nginx_ingress_controller_requests Prometheus ölçümünde kaydeder.

HPA, Prometheus ölçümlerini doğrudan tüketemez; Kubernetes external metrics API aracılığıyla sunulan ölçümleri gerektirir. ack-alibaba-cloud-metrics-adapter, nginx_ingress_controller_requests öğesini dört adımda işleyerek bu boşluğu doldurur:


Adım


Alan


Rol


Burada kullanılan değer


1. Keşif


seriesQuery


Sunulacak Prometheus ölçümünü tanımlar


nginx_ingress_controller_requests


2. İlişkilendirme


resources


Bu ölçümün ad alanı kapsamında olup olmadığını belirtir


namespaced: false


3. Adlandırma


name


Dış API'deki ölçümü yeniden adlandırır


_requests kısmını kaldırır, _per_second ekler → nginx_ingress_controller_per_second


4. Sorgulama


metricsQuery


Değeri hesaplamak için kullanılan PromQL şablonunu tanımlar


sum(rate(<<.Series>>{<<.LabelMatchers>>}[2m]))

Adaptör, sorgu zamanında bu metricsQuery şablon değişkenlerini doldurur:

  • <<.Series>> — Eşleşen Prometheus seri adıyla değiştirilir (nginx_ingress_controller_requests)

  • <<.LabelMatchers>> — HPA spesifikasyonundaki etiket seçicilerle değiştirilir (örneğin, service="sample-app")

Her HPA, bu ölçümü tek bir uygulamaya filtrelemek için selector.matchLabels.service kullanır; böylece sample-app ve test-app ölçeklendirmeleri bağımsız kalır.

Adım 1: Uygulamaları ve hizmetleri oluşturun

İki Dağıtım ve bunlara karşılık gelen Hizmetler oluşturun.

  1. Aşağıdaki içerikle nginx1.yaml dosyasını oluşturun:

    YAML örneği

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: test-app
      namespace: default
      labels:
        app: test-app
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: test-app
      template:
        metadata:
          labels:
            app: test-app
        spec:
          containers:
          - image: registry-cn-hangzhou.ack.aliyuncs.com/acs/sample-app:v1-b070784-aliyun
            name: metrics-provider
            ports:
            - name: http
              containerPort: 8080
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: test-app
      namespace: default
      labels:
        app: test-app
    spec:
      ports:
        - port: 8080
          name: http
          protocol: TCP
          targetPort: 8080
      selector:
        app: test-app
      type: ClusterIP

    Manifestoyu uygulayın:

    kubectl apply -f nginx1.yaml
  2. Aşağıdaki içerikle nginx2.yaml dosyasını oluşturun:

    YAML örneği

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: sample-app
      namespace: default
      labels:
        app: sample-app
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: sample-app
      template:
        metadata:
          labels:
            app: sample-app
        spec:
          containers:
          - image: registry-cn-hangzhou.ack.aliyuncs.com/acs/sample-app:v1-b070784-aliyun
            name: metrics-provider
            ports:
            - name: http
              containerPort: 8080
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: sample-app
      namespace: default
      labels:
        app: sample-app
    spec:
      ports:
        - port: 80
          name: http
          protocol: TCP
          targetPort: 8080
      selector:
        app: sample-app
      type: ClusterIP

    Manifestoyu uygulayın:

    kubectl apply -f nginx2.yaml

Adım 2: Bir Ingress oluşturun

  1. Aşağıdaki içerikle ingress.yaml dosyasını oluşturun:


    Alan


    Açıklama


    host


    Hizmet erişimi için alan adı. Bu örnekte test.example.com olarak ayarlanır.


    path


    URL yolu. Bu yolla eşleşen istekler ilgili Service'e yönlendirilir.


    backend


    Her yol için hedef Service adı ve bağlantı noktası. / yolu sample-app hizmetine; /home yolu test-app hizmetine yönlendirilir.

    YAML örneği

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: test-ingress
      namespace: default
    spec:
      ingressClassName: nginx
      rules:
        - host: test.example.com
          http:
            paths:
              - backend:
                  service:
                    name: sample-app
                    port:
                      number: 80
                path: /
                pathType: ImplementationSpecific
              - backend:
                  service:
                    name: test-app
                    port:
                      number: 8080
                path: /home
                pathType: ImplementationSpecific

    Manifestoyu uygulayın:

    kubectl apply -f ingress.yaml
  2. Ingress'in çalıştığını doğrulayın:

    kubectl get ingress -o wide

    Beklenen çıktı:

    NAME           CLASS   HOSTS              ADDRESS       PORTS   AGE
    test-ingress   nginx   test.example.com   10.XX.XX.10   80      55s

    NGINX Ingress Controller, test.example.com/ trafiğini sample-app hizmetine ve test.example.com/home trafiğini test-app hizmetine yönlendirir. Her iki istek akışı da hizmet adına göre etiketlenerek nginx_ingress_controller_requests Prometheus ölçümünde kaydedilir.

Adım 3: Prometheus ölçümlerini HPA uyumlu ölçümlere dönüştürün

HPA, ölçümleri doğrudan Prometheus'tan değil, Kubernetes external metrics API'sinden okur. ack-alibaba-cloud-metrics-adapter, Prometheus ölçümlerini adapter-config ConfigMap'indeki kurallar aracılığıyla bu biçime çevirir.

adapter-config dosyasını değiştirin

  1. ACK console üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında istediğiniz kümeyi bulun ve adına tıklayın. Sol bölmede Applications > Helm seçeneklerini belirleyin.

  3. Helm sayfasında ack-alibaba-cloud-metrics-adapter seçeneğine tıklayın. Resource bölümünde adapter-config seçeneğine tıklayın, ardından sağ üst köşede Edit YAML seçeneğine tıklayın.

  4. Mevcut kuralları aşağıdakilerle değiştirin, ardından OK seçeneğine tıklayın:

    Tüm adaptör yapılandırma seçenekleri Alibaba Cloud Prometheus ölçümlerine dayalı yatay pod otomatik ölçeklendirme belgesinde açıklanmıştır.
    rules:
    - metricsQuery: sum(rate(<<.Series>>{<<.LabelMatchers>>}[2m]))
      name:
        as: ${1}_per_second
        matches: ^(.*)_requests
      resources:
        namespaced: false
      seriesQuery: nginx_ingress_controller_requests

    image

Ölçümün kullanılabilir olduğunu doğrulayın

Adaptörün dönüştürülen ölçümü sunduğunu onaylayın:

kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/*/nginx_ingress_controller_per_second" | jq .

Beklenen çıktı:

{
  "kind": "ExternalMetricValueList",
  "apiVersion": "external.metrics.k8s.io/v1beta1",
  "metadata": {},
  "items": [
    {
      "metricName": "nginx_ingress_controller_per_second",
      "metricLabels": {},
      "timestamp": "2025-07-25T07:56:04Z",
      "value": "0"
    }
  ]
}

value değerinin "0" olması beklenir — henüz trafik yoktur.

Adım 4: HPA'ları oluşturun

Her iki HPA da aynı nginx_ingress_controller_per_second dış ölçümünü kullanır ancak selector.matchLabels.service kullanarak bunu ilgili hizmete göre filtreler. Adaptör, bu etiketleri PromQL sorgusuna <<.LabelMatchers>> olarak geçirir; böylece her uygulamanın ölçeklendirme kararları bağımsız kalır.

  1. Aşağıdaki içerikle hpa.yaml dosyasını oluşturun:

    YAML örneği

    apiVersion: autoscaling/v2
    kind: HorizontalPodAutoscaler
    metadata:
      name: sample-hpa
      namespace: default
    spec:
      scaleTargetRef:
        apiVersion: apps/v1
        kind: Deployment
        name: sample-app
      minReplicas: 1
      maxReplicas: 10
      metrics:
        - type: External
          external:
            metric:
              name: nginx_ingress_controller_per_second
              selector:
                matchLabels:
    # Filters the metric to requests for this service only.
    # The labels set here are passed to <<.LabelMatchers>> in the adapter rule.
                  service: sample-app
    # External metrics support only Value and AverageValue target types.
            target:
              type: AverageValue
              averageValue: 30
    ---
    apiVersion: autoscaling/v2
    kind: HorizontalPodAutoscaler
    metadata:
      name: test-hpa
      namespace: default
    spec:
      scaleTargetRef:
        apiVersion: apps/v1
        kind: Deployment
        name: test-app
      minReplicas: 1
      maxReplicas: 10
      metrics:
        - type: External
          external:
            metric:
              name: nginx_ingress_controller_per_second
              selector:
                matchLabels:
    # Filters the metric to requests for this service only.
    # The labels set here are passed to <<.LabelMatchers>> in the adapter rule.
                  service: test-app
    # External metrics support only Value and AverageValue target types.
            target:
              type: AverageValue
              averageValue: 30

    Manifestoyu uygulayın:

    kubectl apply -f hpa.yaml
  2. Her iki HPA'nın da hazır olduğunu doğrulayın:

    kubectl get hpa

    Beklenen çıktı:

    NAME         REFERENCE               TARGETS       MINPODS   MAXPODS   REPLICAS   AGE
    sample-hpa   Deployment/sample-app   0/30 (avg)   1         10        1          74s
    test-hpa     Deployment/test-app     0/30 (avg)   1         10        1          59m

    Her iki HPA da 0/30 (avg) değerini gösterir; bu, mevcut istek oranının pod başına saniyede 30 isteğe yönelik ölçeklendirme eşiğinin altında olduğu anlamına gelir.

Adım 5: Otomatik ölçeklendirmeyi doğrulayın

Apache Benchmark kullanarak trafik oluşturup her bir HPA'nın bağımsız olarak yanıt vermesini izleyin.

  1. test-app hizmetine yönlendirilen /home yoluna 5.000 istek gönderin:

    ab -c 50 -n 5000 test.example.com/home
  2. HPA durumunu gerçek zamanlı olarak izleyin:

    kubectl get hpa --watch

    Yük sonrasında test-hpa ölçeği genişletirken sample-hpa tek çoğaltmada kalır:

    NAME         REFERENCE               TARGETS           MINPODS   MAXPODS   REPLICAS   AGE
    sample-hpa   Deployment/sample-app   0/30 (avg)        1         10        1          22m
    test-hpa     Deployment/test-app     22096m/30 (avg)   1         10        3          80m

    İzlemeyi durdurmak için Ctrl+C tuşlarına basın.

  3. Kök yola (sample-app hizmetine yönlendirilen) 5.000 istek gönderin:

    ab -c 50 -n 5000 test.example.com/
  4. HPA durumunu tekrar kontrol edin:

    kubectl get hpa

    Beklenen çıktı:

    NAME         REFERENCE               TARGETS           MINPODS   MAXPODS   REPLICAS   AGE
    sample-hpa   Deployment/sample-app   27778m/30 (avg)   1         10        2          38m
    test-hpa     Deployment/test-app     0/30 (avg)        1         10        1          96m

    sample-hpa yük altında ölçeği genişletirken test-hpa, /home trafiği durduktan sonra ölçeği geri küçülttü. Her uygulama kendi trafiğine göre bağımsız olarak ölçeklendi.

Sonraki adımlar

  • Çoklu alan otomatik ölçeklendirme: Veri yoğun, yüksek kullanılabilirlik gerektiren hizmetler için Birden çok alanda aynı anda ölçeklendirme konusuna bakın.

  • Elastik ölçeklendirme için özel OS görüntüleri: Belirli düğüm gereksinimleri olan ortamlarda otomatik ölçeklendirmeyi özel görüntüler kullanarak basitleştirin.