Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Perform canary releases with ALB Ingresses in an ACK cluster

Son Güncelleme:Oct 06, 2026

Hizmet güncellemeleri sırasında sistem kararlılığını korumak için canary yayınlarını kullanın. ALB Ingress; başlık, çerez veya ağırlık bazında canary ek açıklamalarını destekler (öncelik sırası: başlık > çerez > ağırlık). Üretim ortamındaki trafiğin bir kısmını yeni Service sürümüne yönlendirerek doğrulayın ve hazır olduğunda bu sürümü tanıtın.

Ön koşullar

Aşağıdaki adımları tamamlayın:

Canary ek açıklamaları

Her canary Ingress için alb.ingress.kubernetes.io/canary: "true" ek açıklaması gereklidir. Bu açıklama yoksa canary Ingress, üretim trafiğiyle paralel yönlendirme yapmak yerine çatışmaya neden olur.

Trafik bölme işlemini aşağıdaki ek açıklamalarla kontrol edebilirsiniz:

Ek Açıklama Açıklama
alb.ingress.kubernetes.io/canary Ingress'i canary olarak işaretler. Değer olarak "true" ayarlayın. Her canary Ingress için zorunludur.
alb.ingress.kubernetes.io/canary-by-header Eşleştirilecek istek başlığı anahtarı. Eşleşen istekler canary Service'e yönlendirilir.
alb.ingress.kubernetes.io/canary-by-header-value Eşleştirilecek başlık değeri. canary-by-header ek açıklamasını gerektirir; ilgili ek açıklama ayarlanmamışsa yoksayılır.
alb.ingress.kubernetes.io/canary-weight Başlık veya çerez kuralıyla eşleşme olmadığında canary Service'e gidecek trafik yüzdesi (0–100). 0 hiçbir trafiği göndermez; 100 tüm trafiği gönderir.
alb.ingress.kubernetes.io/order Yönlendirme kuralı değerlendirme sırası. Geçerli değerler: 1–1000. Varsayılan: 10. Düşük değerler daha yüksek önceliğe sahiptir. Bu ek açıklama olmadan sıra, Ingress ad alanı ve adına göre leksikografik olarak belirlenir.

Kural önceliği: başlık tabanlı > çerez tabanlı > ağırlık tabanlı.

Kullanım notları

  • Başlık ve çerez tabanlı kurallar, ağırlık tabanlı kurallarla aynı Ingress içinde bulunamaz. Ayrı Ingress'ler kullanın veya karmaşık koşullar için özel yönlendirme kurallarını tercih edin.

  • Canary Ingress host değeri, üretim Ingress host değeriyle tam olarak eşleşmelidir.

  • Birden fazla canary Ingress aynı host'u paylaştığında leksikografik sıralamaya güvenmek yerine alb.ingress.kubernetes.io/order ile açık öncelik ayarlayın.

Adım 1: Üretim Service'ini dağıtın

Üretim Deployment, Service ve Ingress kaynaklarını dağıtın.

  1. tea-deploy.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: tea
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: tea
      template:
        metadata:
          labels:
            app: tea
        spec:
          containers:
          - name: tea
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/old-nginx:latest
            ports:
            - containerPort: 80
    kubectl apply -f tea-deploy.yaml
  2. tea-svc.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: v1
    kind: Service
    metadata:
      name: tea-svc
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: tea
      type: NodePort
    kubectl apply -f tea-svc.yaml
  3. tea-ingress.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: tea-ingress
    spec:
      ingressClassName: alb
      rules:
       - host: demo.domain.ingress.top  # Replace with your domain name, resolved to the load balancer IP.
         http:
          paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: tea-svc
                port:
                  number: 80
    kubectl apply -f tea-ingress.yaml

Adım 2: Canary Service ve yönlendirme kurallarını dağıtın

Canary Service'i iki canary Ingress ile dağıtın: Biri başlığa göre yönlendirme yaparken diğeri kalan trafiği ağırlığa göre böler.

Canary Ingress'leri uygulamadan önce şunlara dikkat edin:

  • Her canary Ingress için alb.ingress.kubernetes.io/canary: "true" ayarlayın. Bu ayar yapılmazsa canary Ingress üretim trafiğiyle çatışır.

  • host alanı, üretim Ingress host değeriyle tam olarak eşleşmelidir (bu örnekte demo.domain.ingress.top).

  • Başlık tabanlı ve ağırlık tabanlı kurallar ayrı Ingress'lerde tanımlanmalıdır.

  1. canary-deploy.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: canary
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: canary
      template:
        metadata:
          labels:
            app: canary
        spec:
          containers:
          - name: canary
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/new-nginx:latest
            ports:
            - containerPort: 80
    kubectl apply -f canary-deploy.yaml
  2. canary-svc.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: v1
    kind: Service
    metadata:
      name: canary-svc
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: canary
      type: NodePort
    kubectl apply -f canary-svc.yaml
  3. Başlık tabanlı bir canary Ingress oluşturun. location: hz başlığını içeren istekler canary-svc hizmetine yönlendirilir; diğer başlıklar sonraki kurala geçer. canary-header-ingress.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        alb.ingress.kubernetes.io/canary: "true"
        alb.ingress.kubernetes.io/canary-by-header: "location"
        alb.ingress.kubernetes.io/canary-by-header-value: "hz"
      name: canary-header-ingress
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: demo.domain.ingress.top  # Must match the production Ingress host exactly.
          http:
            paths:
              - backend:
                  service:
                    name: canary-svc
                    port:
                      number: 80
                path: /
                pathType: Prefix
    kubectl apply -f canary-header-ingress.yaml
  4. Ağırlık tabanlı bir canary Ingress oluşturun. Eşleşmeyen istekler üretim ve canary Service'leri arasında %50/%50 oranında bölünür. canary-weight-ingress.yaml dosyasını oluşturun ve uygulayın:

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        alb.ingress.kubernetes.io/canary: "true"
        alb.ingress.kubernetes.io/canary-weight: "50"
      name: canary-weight-ingress
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: demo.domain.ingress.top  # Must match the production Ingress host exactly.
          http:
            paths:
              - backend:
                  service:
                    name: canary-svc
                    port:
                      number: 80
                path: /
                pathType: Prefix
    kubectl apply -f canary-weight-ingress.yaml

Canary yayınını doğrulayın

  1. ALB örnek adresini alın:

    kubectl get ing

    Beklenen çıktı:

    NAME                    CLASS   HOSTS                     ADDRESS                                              PORTS   AGE
    canary-header-ingress   alb     demo.domain.ingress.top   alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com   80      8m23s
    canary-weight-ingress   alb     demo.domain.ingress.top   alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com   80      8m16s
    tea-ingress             alb     demo.domain.ingress.top   alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com   80      7m5s
  2. location: hz başlığını taşıyan isteklerin her zaman canary'e ulaştığını doğrulayın:

    for i in $(seq 1 10); do curl -s -H "Host:demo.domain.ingress.top" -H "location:hz" http://alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com; done

    10 yanıtın tamamı new döndürür. Başlık kuralı en yüksek önceliğe sahiptir ve eşleşen tüm istekleri canary'e yönlendirir.

  3. Eşleşen başlık içermeyen isteklerin yaklaşık %50/%50 oranında bölündüğünü doğrulayın:

    for i in $(seq 1 10); do curl -s -H "Host:demo.domain.ingress.top" http://alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com; done

    Yanıtlar new (canary) ve old (üretim) arasında değişir; her biri yaklaşık yarısını oluşturur. Eşleşmeyen başlıklar (örneğin location: bj) de aynı ağırlık tabanlı bölme işlemine tabi tutulur.

Adım 3: Yeni sürümü tanıtın

Canary yayını stabil hale geldikten sonra tüm üretim trafiğini yeni Service'e yönlendirin ve canary Ingress'leri silin.

  1. tea-ingress.yaml dosyasını canary-svc hizmetini gösterecek şekilde güncelleyin:

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: tea-ingress
    spec:
      ingressClassName: alb
      rules:
       - host: demo.domain.ingress.top
         http:
          paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: canary-svc  # Changed from tea-svc.
                port:
                  number: 80
    kubectl apply -f tea-ingress.yaml
  2. Canary Ingress'leri silin:

    kubectl delete ing canary-weight-ingress canary-header-ingress
  3. Tüm trafiğin yeni sürüme ulaştığını doğrulayın:

    for i in $(seq 1 10); do curl -s -H "Host:demo.domain.ingress.top" http://alb-ny3ute4r8yevni****.cn-chengdu.alb.aliyuncs.com; done

    10 yanıtın tamamı new döndürür. Eski Service sürümü tamamen kullanım dışı bırakılmıştır.

Sonraki adımlar

Kaynaklar