Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Manage north-south traffic

Son Güncelleme:Oct 06, 2026

Her küme için ayrı giriş denetleyicileri yönetmek zorunda kalmadan, ALB çok küme ağ geçitlerini kullanarak birden fazla ACK kümesindeki kuzey-güney trafiğini yönetin. Aktif alan yedekliliği, yük dengeleme ve üst bilgi tabanlı yönlendirme ile desteklenir.

Ön koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Nasıl çalışır

Trafik internetten ALB örneği aracılığıyla ilişkili kümelerinizdeki pod'lara akar:

Internet → ALB instance → ACK One Fleet instance → Associated cluster 1 (pods)
                                                  → Associated cluster 2 (pods)

Fleet örneği kontrol düzlemi olarak işlev görür. Fleet örneğindeki bir AlbConfig nesnesi ALB örneğini sağlar. Fleet örneğindeki Ingress kuralları, ALB'nin trafiği tüm ilişkili kümelerdeki pod'lara nasıl yönlendireceğini belirler.

Adım 1: Bir ALB çok küme ağ geçidi oluşturun

ALB örneğini sağlamak ve ilişkili kümeleri trafik hedefleri olarak kaydetmek için Fleet örneğinde bir AlbConfig nesnesi oluşturun.

  1. Fleet örneğinin bulunduğu VPC'den iki vSwitch'in kimliklerini alın.

  2. Aşağıdaki içerikle gateway.yaml dosyasını oluşturun. ${vsw-id1} ve ${vsw-id2} değerlerini vSwitch kimlikleriyle, ${cluster1} ve ${cluster2} değerlerini ise ilişkili kümelerin kimlikleriyle değiştirin.

    Her ilişkili küme için ( ${cluster1} ve ${cluster2} ), güvenlik gruplarının gelen kurallarını vSwitch CIDR bloğundaki tüm IP adreslerinden ve bağlantı noktalarından gelen trafiğe izin verecek şekilde yapılandırın.
    Parametre Zorunlu Açıklama
    metadata.name Evet AlbConfig adı.
    metadata.annotations: alb.ingress.kubernetes.io/remote-clusters Evet ALB çok küme ağ geçidine eklenecek küme kimliklerinin virgülle ayrılmış listesi. Her küme kimliği zaten Fleet örneğiyle ilişkilendirilmiş olmalıdır.
    spec.config.name Hayır ALB örneğinin adı.
    spec.config.addressType Hayır ALB örneğinin ağ türü. Internet (varsayılan): genel kullanıma açık, esnek bir IP adresi (EIP) gerektirir; örnek ücretleri ve bant genişliği için ücretlendirilir. Intranet: özel, yalnızca VPC içinde erişilebilir.
    spec.config.zoneMappings Evet ALB örneği için vSwitch kimlikleri. vSwitch'ler ALB tarafından desteklenen alanlarda ve kümelerle aynı VPC'de olmalıdır. Yüksek kullanılabilirlik için bölge destekliyorsa en az iki alandaki vSwitch'leri kullanın. Desteklenen bölgeler ve alanlar için bkz. ALB'nin kullanılabildiği bölgeler ve alanlar.
    spec.listeners Hayır Dinleyici bağlantı noktası ve protokolü. Örnek 8001 bağlantı noktasında HTTP kullanır. Bu yapılandırmayı koruyun; dinleyici olmadan ALB Ingress'lerini kullanamazsınız.
    apiVersion: alibabacloud.com/v1
    kind: AlbConfig
    metadata:
      name: ackone-gateway-demo
      annotations:
        # Add associated clusters that are used to handle traffic to the ALB multi-cluster instance.
        alb.ingress.kubernetes.io/remote-clusters: ${cluster1},${cluster2}
    spec:
      config:
        name: one-alb-demo
        addressType: Internet
        addressAllocatedMode: Fixed
        zoneMappings:
        - vSwitchId: ${vsw-id1}
        - vSwitchId: ${vsw-id2}
      listeners:
      - port: 8001
        protocol: HTTP
    ---
    apiVersion: networking.k8s.io/v1
    kind: IngressClass
    metadata:
      name: alb
    spec:
      controller: ingress.k8s.alibabacloud/alb
      parameters:
        apiGroup: alibabacloud.com
        kind: AlbConfig
        name: ackone-gateway-demo
  3. ALB çok küme ağ geçidini ve IngressClass'ı oluşturmak için bildirimi uygulayın:

    kubectl apply -f gateway.yaml
  4. 1 ila 3 dakika sonra ağ geçidinin oluşturulduğunu doğrulayın:

    kubectl get albconfig ackone-gateway-demo

    Beklenen çıktı:

    NAME                  ALBID      DNSNAME                                    PORT&PROTOCOL   CERTID   AGE
    ackone-gateway-demo   alb-xxxx   alb-xxxx.<regionid>.alb.aliyuncs.com                              4d9h
  5. İlişkili kümelerin ağ geçidine bağlı olduğunu doğrulayın:

    kubectl get albconfig ackone-gateway-demo -ojsonpath='{.status.loadBalancer.subClusters}'

    Çıktı küme kimliklerinin bir listesidir.

Adım 2: Ingress ile trafiği yönlendirin

ALB çok küme ağ geçidini kullanmak için ingressClassName: alb içeren bir Ingress oluşturun. ALB Ingress'leri yaygın olarak kullanılan Nginx Ingress ek açıklamalarını destekler ve ALB örnekleri için gelişmiş özellikler sunar. Desteklenen ek açıklamaların tam listesi için bkz. Ek açıklamalarla ALB Ingress yapılandırması.

Aşağıdaki tabloda bu bölümde ele alınan dört yönlendirme senaryosu özetlenmiştir:

Senaryo Ne zaman kullanılır Anahtar ek açıklama
Varsayılan yük dengeleme Trafiği çoğaltma sayısına göre tüm kümelere dağıtmak için Gerekli değil
Tek küme yönlendirmesi Tüm trafiği tek bir kümeye göndermek için (yalıtım veya test amacıyla) alb.ingress.kubernetes.io/cluster-weight.{clusterID}: "100"
Üst bilgi tabanlı yönlendirme Belirli bir üst bilgiye sahip istekleri belirlenen bir kümeye yönlendirmek için alb.ingress.kubernetes.io/conditions.{service}
Ağırlık tabanlı yönlendirme Trafiği tanımlanan yüzdelerle kümeler arasında bölmek için alb.ingress.kubernetes.io/cluster-weight.{clusterID} (birden fazla)

Örnek 1: Varsayılan yük dengeleme

Trafiği çoğaltma sayısına göre ağırlıklandırarak ilişkili kümelerdeki tüm arka uç pod'larına dağıtın. Küme ağırlığı ek açıklamasına gerek yoktur. Küme başına ağırlıkları özelleştirmeden basit ve otomatik yük dağıtımı istediğinizde bunu kullanın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: |
     [{"HTTP": 8001}]
  name: alb-ingress
  namespace: demo
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: service1
            port:
              number: 80

Örnek 2: Tek küme yönlendirmesi

Tüm trafiği belirli bir kümeye yönlendirin. Örneğin, bir olay sırasında bir kümeyi yalıtmak veya canary trafiğini tek bir kümeye yönlendirmek için kullanın. Küme ağırlığını "100" olarak ayarlayın. Belirtilen küme mevcut değilse sistem onu atlar.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: |
     [{"HTTP": 8001}]
    alb.ingress.kubernetes.io/cluster-weight.c6XXXXXXXXXXXXXXXXXXXXXXXXX: "100"
  name: alb-ingress
  namespace: demo
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: service1
            port:
              number: 80

Örnek 3: Üst bilgi tabanlı yönlendirme

Belirli bir HTTP üst bilgi değerine sahip istekleri belirlenen bir kümeye yönlendirin. Örneğin, stage: gray üst bilgisine sahip istekleri gri sürüm kümesine göndermek için kullanın. Üst bilgi eşleşme kuralını tanımlamak için alb.ingress.kubernetes.io/conditions.{service} ek açıklamasını ve hedef kümeyi belirtmek için alb.ingress.kubernetes.io/cluster-weight.{clusterID} ek açıklamasını kullanın. Belirtilen küme mevcut değilse sistem onu atlar.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: |
     [{"HTTP": 8001}]
    alb.ingress.kubernetes.io/conditions.service1: |
     [{
       "type": "Header",
       "headerConfig": {
          "key":"stage",
           "values": [
              "gray"
           ]
       }
      }]
    alb.ingress.kubernetes.io/cluster-weight.c6XXXXXXXXXXXXXXXXXXXXXXXXX: "100"
  name: alb-ingress
  namespace: demo
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: service1
            port:
              number: 80

Örnek 4: Ağırlık tabanlı yönlendirme

Trafiği tanımlanan yüzdelerle kümeler arasında bölün. Örneğin, bir geçiş sırasında trafiği yavaş yavaş bir kümeden diğerine kaydırmak için kullanın. Tüm küme ağırlıklarının toplamı 100'e eşit olmalıdır.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: |
     [{"HTTP": 8001}]
    alb.ingress.kubernetes.io/cluster-weight.c6XXXXXXXXXXXXXXXXXXXXXXXXX: "60"
    alb.ingress.kubernetes.io/cluster-weight.cdXXXXXXXXXXXXXXXXXXXXXXXXX: "40"
  name: alb-ingress
  namespace: demo
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: service1
            port:
              number: 80

Sorun giderme

Ağ geçidi 3 dakika sonra oluşturulmadı

Hata ayrıntıları için AlbConfig durumunu inceleyin:

kubectl describe albconfig ackone-gateway-demo

Yaygın nedenler:

  • vSwitch'ler ALB tarafından desteklenen alanlarda değil. ALB'nin kullanılabildiği bölgeler ve alanlar kullanarak doğrulayın.

  • İlişkili kümelerin güvenlik grubu gelen kuralları vSwitch CIDR bloğundan gelen trafiğe izin vermiyor.

İlişkili kümeler subClusters içinde görünmüyor

alb.ingress.kubernetes.io/remote-clusters ek açıklamasındaki küme kimliklerinin Fleet örneğiyle ilişkilendirilmiş kümelerin kimlikleriyle eşleştiğini doğrulayın:

kubectl get albconfig ackone-gateway-demo -ojsonpath='{.status.loadBalancer.subClusters}'

Çıktı boşsa gateway.yaml dosyasındaki küme kimliklerinin doğru olduğunu ve kümelerin Fleet örneğiyle ilişkilendirildiğini onaylayın.

Sonraki adımlar