Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Implement horizontal pod autoscaling

Son Güncelleme:Oct 06, 2026

CPU, bellek veya diğer ölçümlere göre pod çoğaltmalarını otomatik olarak ölçeklendirmek için HPA'yı yapılandırın.

HPA; talebi dalgalanan, sık ölçeklendirme gerektiren veya çok sayıda iş yüküne sahip hizmetler için uygundur. Bu durum e-ticaret, çevrimiçi eğitim ve finansal hizmetlerde yaygındır.

HPA'nın çalışma şekli

HPA bir kontrol döngüsü olarak çalışır: Denetleyici her 15 saniyede bir Metrics API'yi sorgular ve kullanımı hedeflerinizle karşılaştırır. Metrics API verileri kubelet'ten her 60 saniyede bir aldığından HPA ölçümleri etkili bir şekilde 60 saniyelik bir döngüde değerlendirir.

Temel ölçeklendirme formülü:

desiredReplicas = ceil(currentReplicas * (currentMetricValue / desiredMetricValue))

Örneğin, mevcut CPU kullanımı %80 ve hedef %50 ise HPA ceil(currentReplicas * 80/50) değerini hesaplar ve Dağıtımı ölçeklendirir. %10'luk bir tolerans bandı titremeyi önler; oran 1,0'a 0,1 mesafe içinde olduğunda HPA ölçeklendirme yapmaz.


Davranış


Detay


Ölçek büyütme


Anında gerçekleşir. Bir ölçüm hedefi (tolerans dahil) aştığında HPA çoğaltma sayısını hemen artırır.


Ölçek küçültme


Geçici düşüşler sırasında erken ölçek küçültmeyi önlemek için varsayılan 5 dakikalık bekleme süresi uygulanır.


Birden fazla ölçüm


Belirtilen herhangi bir ölçüm eşiği aştığında HPA ölçeklendirme yapar.


Kaynak istekleri gereklidir


HPA kullanımı currentUsage / requests olarak hesaplar. Kaynak istekleri olmadan HPA kullanımı hesaplayamaz.

Bkz. Algoritma ayrıntıları.

Ön koşullar

ACK konsolunda HPA etkin uygulamayı oluşturma

  1. ACK konsoluna giriş yapın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında hedef kümeyi bulun ve adına tıklayın veya Actions sütunundaki Details seçeneğine tıklayın.

  3. Sol gezinme bölmesinde Workloads > Deployments seçeneğini belirleyin.

  4. Deployments sayfasında Create from Image seçeneğine tıklayın.

  5. Create sayfasında aşağıdaki bölümleri yapılandırın:

    • Basic Information: Uygulama adını ve çoğaltma sayısını ayarlayın.

    • Container: Görüntüyü seçin ve CPU ile bellek kaynaklarını belirtin. > Önemli: Kaynak isteklerini ayarlayın, aksi takdirde HPA çalışmaz.

    • Advanced:

      • Access Control bölümünde Hizmet'i yapılandırmak için Create yanındaki Services seçeneğine tıklayın.

      • Scaling bölümünde HPA değerini Enable olarak ayarlayın ve ölçeklendirme parametrelerini yapılandırın:


        Parametre


        Açıklama


        Ölçümler


        CPU Kullanımı veya Bellek Kullanımı seçin. Gerekli Kaynaklardaki kaynak türüyle eşleşmelidir. İkisi de belirtilirse HPA herhangi biri eşiği aştığında ölçeklendirme yapar.


        Koşul


        Ölçeklendirmeyi tetikleyen kaynak kullanımı eşiği.


        Maks. Çoğaltma


        Maksimum çoğaltma sayısı. Minimum değerden büyük olmalıdır.


        Min. Çoğaltma


        Minimum çoğaltma sayısı. Tam sayıdır, en az 1 olmalıdır.

Bkz. Görüntüden durumsuz uygulama oluşturma.

kubectl ile HPA etkin uygulamayı oluşturma

Bu bölümde kubectl ile HPA yapılandırmasını göstermek için bir NGINX Dağıtımı kullanılmaktadır. İş yükü başına yalnızca bir HPA oluşturun.

Adım 1: Dağıtım oluşturma

nginx.yml adlı bir dosya oluşturun:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
  labels:
    app: nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.7.9 # Replace with your actual image_name:tag.
        ports:
        - containerPort: 80
        resources:
          requests:       # Required for HPA to calculate utilization.
            cpu: 500m
Önemli

Konteynerleriniz için resources.requests tanımlayın. HPA kullanımı currentUsage / requests olarak hesaplar; istekler olmadan kullanımı belirleyemez ve ölçeklendirme yapmaz.

Dağıtımı uygulayın:

kubectl apply -f nginx.yml

Adım 2: HPA oluşturma

hpa.yml adlı bir dosya oluşturun. HPA, scaleTargetRef kullanarak nginx Dağıtımını hedefler ve ortalama CPU kullanımı %50'yi aştığında ölçeklendirme yapar.

Kubernetes 1.24 ve sonraki sürümler için (önerilir -- autoscaling/v2 kullanır):

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: nginx-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx                # Target Deployment name.
  minReplicas: 1               # Minimum replica count. Integer >= 1.
  maxReplicas: 10              # Maximum replica count. Must exceed minReplicas.
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 50 # Target average CPU utilization (percentage of requests).

1.24'ten önceki Kubernetes sürümleri için (eski)

Bunun yerine autoscaling/v2beta2 kullanın:

apiVersion: autoscaling/v2beta2
kind: HorizontalPodAutoscaler
metadata:
  name: nginx-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx
  minReplicas: 1
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 50
autoscaling/v2beta2 Kubernetes 1.23'te kullanım dışı bırakılmış ve 1.26'da kaldırılmıştır. Mümkün olduğunda autoscaling/v2 sürümüne yükseltin.

HPA'yı uygulayın:

kubectl apply -f hpa.yml

(İsteğe bağlı) Birden fazla ölçüm kullanma

Hem CPU hem de belleğe dayalı ölçeklendirme yapmak için tek bir HPA'daki metrics alanı altında her iki kaynak türünü de belirtin; her ölçüm için ayrı HPA'lar oluşturmayın. HPA, herhangi bir ölçüm eşiğini aştığında ölçeklendirme yapar.

metrics:
- type: Resource
  resource:
    name: cpu
    target:
      type: Utilization
      averageUtilization: 50
- type: Resource
  resource:
    name: memory
    target:
      type: Utilization
      averageUtilization: 50

HPA durumunu doğrulama

HPA'yı uyguladıktan sonra ilk ölçüm toplama işlemi birkaç dakika sürer. Bu süre zarfında kubectl describe hpa komutu aşağıdakine benzer uyarılar gösterebilir:

Warning  FailedGetResourceMetric       2m (x6 over 4m)  horizontal-pod-autoscaler  missing request for cpu on container nginx in pod default/nginx-deployment-basic-75675f5897-mqzs7

Warning  FailedComputeMetricsReplicas  2m (x6 over 4m)  horizontal-pod-autoscaler  failed to get cpu utilization: missing request for cpu on container nginx in pod default/nginx-deployment-basic-75675f5

Bu uyarılar HPA'nın henüz başlatıldığını ve ölçümlerin henüz mevcut olmadığını gösterir.

HPA durumunu kontrol edin:

kubectl get hpa

Ölçeklendirme olaylarını kontrol edin:

kubectl describe hpa nginx-hpa

HPA doğru şekilde çalıştığında Olaylar bölümü aşağıdakine benzer bir çıktı gösterir:

Type    Reason             Age   From                       Message
----    ------             ----  ----                       -------
Normal  SuccessfulRescale  5m6s  horizontal-pod-autoscaler  New size: 1; reason: All metrics below target

Temizleme

Bu eğitimde oluşturulan kaynakları kaldırmak için:

kubectl delete hpa nginx-hpa
kubectl delete deployment nginx

Sonraki adımlar