Tüm Ürünler
Search
Belge Merkezi

Elastic Container Instance:Spread Elastic Container Instance-based pods across zones and configure affinities

Son Güncelleme:Oct 06, 2026

Tek bir düğüm arızalandığında, o düğümdeki tüm pod'lar da başarısız olur. Pod'ları kullanılabilirlik alanlarına yaymak bu tek hata noktasını ortadan kaldırır. İş yükü bileşenlerinin iletişim kurması gerektiğinde, bunları aynı alanda konumlandırmak alanlar arası ağ gecikme süresini ve veri aktarım maliyetlerini azaltır.

ACK Pro kümelerinde ve ACK Serverless Pro kümelerinde Kubernetes yerel zamanlaması—topologySpreadConstraints, nodeAffinity ve podAffinity—Elastic Container Instance (ECI) tabanlı pod'ların alanlar arasında nasıl dağıtılacağını belirler. Bu konuda, her bir yaklaşımın çalışan örneklerle nasıl yapılandırılacağı açıklanmaktadır.

Önemli

Alan dağıtımı ve benzeşim yalnızca bir pod üzerinde topologySpreadConstraints, nodeAffinity veya podAffinity yapılandırıldığında ya da pod mevcut bir kaynak ilkesiyle eşleştiğinde etkili olur.

Ön koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Kullanım notları

  • topologyKey değerini topology.kubernetes.io/zone olarak ayarlayın.

  • Aşağıdaki yapılandırmalar alan dağıtımı ve benzeşim ayarlarını geçersiz kılar ve bunların etkili olmasını engeller:

    • Sabit bir vSwitch sıralama stratejisi uygulayan k8s.aliyun.com/eci-schedule-strategy: "VSwitchOrdered" ek açıklaması.

    • Pod hata işleme ilkesini fail-fast olarak ayarlayan k8s.aliyun.com/eci-fail-strategy: "fail-fast" ek açıklaması.

Bir zamanlama yaklaşımı seçin

Hedef Yaklaşım Ne zaman kullanılır
Pod'ları mevcut tüm alanlara eşit şekilde yayma topologySpreadConstraints Yüksek kullanılabilirlik: Tek bir alan kesintisi çoğaltmaların yalnızca bir kısmını etkiler
Pod'ları aynı alandaki mevcut pod'larla birlikte konumlandırma podAffinity Performans: Yeni pod'ların ilgili bir pod grubuyla aynı alanda çalışması gerekir
Pod'ları belirli bir alana sabitleme nodeAffinity Performans: Belirli bir alan, iş yükünüzün gerektirdiği ağ özelliklerine sahiptir

Topoloji yayılım kısıtlamalarını kullanarak pod'ları alanlar arasında yayma

Topoloji yayılım kısıtlamaları, alanlar arasındaki maksimum dengesizliği kontrol etmenize olanak tanır. Anahtar parametre maxSkew değeridir; bu parametre, alanlar arasındaki pod sayıları farkının ne kadar olabileceğini tanımlar.

Kısıtlama karşılanamadığında zamanlamayı engellemek için whenUnsatisfiable: DoNotSchedule değerini veya kısıtlama ihlal edilse bile zamanlamaya izin vermek için ScheduleAnywayYayılım kısıtlaması tanımı değerini ayarlayın.

Tam parametre referansı için bkz. topologySpreadConstraints alanı.

Aşağıdaki örnekler, Kubernetes 1,22 çalıştıran bir ACK Serverless Pro kümesi kullanmaktadır.

Alan yayılımı ile bir Deployment dağıtma

  1. Aşağıdaki içeriğe sahip deployment.yaml adlı bir dosya oluşturun. Bu işlem, alanlar arasında maksimum 1 sapma değeriyle 10 çoğaltmalı bir Deployment oluşturur. topologySpreadConstraints içinde aşağıdaki isteğe bağlı parametreler de kullanılabilir:

    topologySpreadConstraints:
      - maxSkew: <integer>
        minDomains: <integer>         # Optional. Beta in Kubernetes 1.25 and later.
        topologyKey: <string>
        whenUnsatisfiable: <string>
        labelSelector: <object>
        matchLabelKeys: <list>        # Optional. Beta in Kubernetes 1.27 and later.
        nodeAffinityPolicy: [Honor|Ignore]  # Optional. Beta in Kubernetes 1.26 and later.
        nodeTaintsPolicy: [Honor|Ignore]    # Optional. Beta in Kubernetes 1.26 and later.
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: with-pod-topology-spread
      labels:
        app: with-pod-topology-spread
    spec:
      replicas: 10
      selector:
        matchLabels:
          app: with-pod-topology-spread
      template:
        metadata:
          labels:
            app: with-pod-topology-spread
        spec:
          topologySpreadConstraints:
            - maxSkew: 1
              topologyKey: topology.kubernetes.io/zone
              whenUnsatisfiable: DoNotSchedule
              labelSelector:
                matchLabels:
                  app: with-pod-topology-spread
          containers:
          - name: with-pod-topology-spread
            image: registry.k8s.io/pause:2.0
            resources:
              requests:
                cpu: "1"
                memory: "256Mi"
  2. Manifesto'yu uygulayın:

    kubectl apply -f deployment.yaml
  3. Zamanlama sonucunu doğrulayın. Pod'ların hangi düğümlerde çalıştığını kontrol edin:

    kubectl get po -lapp=with-pod-topology-spread -ocustom-columns=NAME:.metadata.name,NODE:.spec.nodeName --no-headers | grep -v "<none>"

    Her alana kaç pod'un yerleştirildiğini kontrol edin:

    kubectl get po -lapp=with-pod-topology-spread -ocustom-columns=NODE:.spec.nodeName --no-headers | grep -v "<none>" | xargs -I {} kubectl get no {} -ojson | jq '.metadata.labels["topology.kubernetes.io/zone"]' | sort | uniq -c

Katı topoloji yayılımının çalışma şekli

Varsayılan olarak, zamanlayıcı yayılımı hesaplarken çalışan pod'ları sayar; bekleyen pod'ların oluşturulmasını beklemez. ECI bazı alanlarda pod oluşturamazsa, maxSkew değerine dayalı yayılım kısıtlaması ihlal edilebilir.

Örneğin, zamanlayıcının pod'ları A Alanı, B Alanı ve C Alanına yerleştirdiğini varsayalım. B Alanı ve C Alanında pod oluşturma başarısız olursa, A Alanında maxSkew: 1 tarafından izin verilenden daha fazla pod bulunur ve B veya C Alanında hiçbir Elastic Container Instance tabanlı pod çalışmaz. Bu durum, maxSkew parametresi tarafından belirtilen kısıtlamayı ihlal eder.

ACK Serverless Pro kümeleri bunu önlemek için katı topoloji yayılımını destekler. Katı topoloji yayılımı etkinleştirildiğinde, zamanlayıcı önce her alana bir pod zamanlar ve zamanlanan pod'lar oluşturulana kadar bekleyen pod'ları zamanlamaz:

image

Zamanlayıcı önce her alana birer pod yerleştirir. İlk küme oluşturulana kadar sonraki pod'ları bekletir:

image

Örneğin, A1 Pod'u oluşturulduktan sonra bile bekleyen pod'lar zamanlanmaz. Bunun nedeni, B Alanı veya C Alanındaki pod oluşturulamazsa maxSkew parametresi tarafından belirtilen kısıtlamanın ihlal edilmesidir. B1 Pod'u oluşturulduktan sonra kube-scheduler C Alanına bir pod zamanlar. Yeşil renkli pod'lar oluşturulur.

image

Katı topoloji yayılımını devre dışı bırakmak için whenUnsatisfiable: ScheduleAnyway değerini ayarlayın. Ayrıntılar için bkz. Yayılım kısıtlaması tanımı.

Benzeşim kullanarak pod'ları belirli bir alana dağıtma

Pod'ların belirli bir alana yerleşmesi gerektiğinde benzeşimi kullanın; bu, mevcut pod'larla birlikte konumlandırma (podAffinity) veya etikete göre belirli bir alanı hedefleme (nodeAffinity) amacıyla olabilir.

Pod'ları mevcut pod'larla aynı alanda birlikte konumlandırma (podAffinity)

Aşağıdaki Deployment, pod benzeşimi kullanarak tek bir alanda dağıtılan pod'lar oluşturur.

  1. Aşağıdaki içeriğe sahip deployment.yaml adlı bir dosya oluşturun:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: with-affinity
      labels:
        app: with-affinity
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: with-affinity
      template:
        metadata:
          labels:
            app: with-affinity
        spec:
          affinity:
            podAffinity:
              requiredDuringSchedulingIgnoredDuringExecution:
              - labelSelector:
                  matchExpressions:
                  - key: app
                    operator: In
                    values:
                    - with-affinity
                topologyKey: topology.kubernetes.io/zone
          containers:
          - name: with-affinity
            image: registry.k8s.io/pause:2.0
  2. Manifesto'yu uygulayın:

    kubectl apply -f deployment.yaml
  3. Zamanlama sonucunu doğrulayın. Pod'ların hangi düğümlerde çalıştığını kontrol edin:

    kubectl get po -lapp=with-affinity -ocustom-columns=NAME:.metadata.name,NODE:.spec.nodeName --no-headers | grep -v "<none>"

    Alan dağılımını kontrol edin:

    kubectl get po -lapp=with-affinity -ocustom-columns=NODE:.spec.nodeName --no-headers | grep -v "<none>" | xargs -I {} kubectl get no {} -ojson | jq '.metadata.labels["topology.kubernetes.io/zone"]' | sort | uniq -c

Pod'ları belirli bir alana sabitleme (nodeAffinity)

Belirli bir alanı hedeflemek için nodeAffinity kullanın ve alan etiketi değerini belirtin. Aşağıdaki örnek, tüm pod'ları Beijing Alan A'ya (cn-beijing-a) sabitler.

  1. Aşağıdaki içeriğe sahip deployment.yaml adlı bir dosya oluşturun:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: with-affinity
      labels:
        app: with-affinity
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: with-affinity
      template:
        metadata:
          labels:
            app: with-affinity
        spec:
          affinity:
            nodeAffinity:
              requiredDuringSchedulingIgnoredDuringExecution:
                nodeSelectorTerms:
                - matchExpressions:
                  - key: topology.kubernetes.io/zone
                    operator: In
                    values:
                    - cn-beijing-a
          containers:
          - name: with-affinity
            image: registry.k8s.io/pause:2.0
  2. Manifesto'yu uygulayın:

    kubectl apply -f deployment.yaml
  3. Zamanlama sonucunu doğrulayın. Pod'ların hangi düğümlerde çalıştığını kontrol edin:

    kubectl get po -lapp=with-affinity -ocustom-columns=NAME:.metadata.name,NODE:.spec.nodeName --no-headers | grep -v "<none>"

    Alan dağılımını kontrol edin:

    kubectl get po -lapp=with-affinity -ocustom-columns=NODE:.spec.nodeName --no-headers | grep -v "<none>" | xargs -I {} kubectl get no {} -ojson | jq '.metadata.labels["topology.kubernetes.io/zone"]' | sort | uniq -c

Sonraki adımlar