Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Use preStop hooks to prevent 502/504 errors during ALB Ingress rolling updates

Son Güncelleme:Oct 06, 2026

preStop uyku gecikmesi, SIGTERM sinyalini erteleyerek ALB Ingress denetleyicisinin kapatma öncesinde pod'u kayıt dışı bırakmasına olanak tanır.

Ön koşullar

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

Bir ACK özel kümesinde ALB Ingress kullanmak için öncelikle ALB Ingress controller için kümeyi yetkilendirin.

Nasıl çalışır

Pod yaşam döngüsü

Bir pod iki tür konteyner içerir:

  • Init container: Başlatma amacıyla ana konteynerden önce çalıştırılır.

  • Main container: Uygulamayı çalıştırır. postStart başlatmadan sonra, liveness ve readiness denetimleri konteyner ömrü boyunca, preStop ise sonlandırmadan önce çalışır.

Aşağıdaki şekil pod yaşam döngüsünü göstermektedir.

image

Hataların nedeni: İki işlem paralel çalışır

Bir pod'un silinmesi, pod sonlandırma ve trafik yönlendirme güncellemeleri olmak üzere iki paralel işlemi tetikler; bu durum 502/504 hatalarına yol açar.

Pod sonlandırma işlemi

  1. kube-apiserver, pod'u Terminating olarak işaretler.

  2. Sistem, yapılandırılmışsa preStop hook'unu çalıştırır.

  3. Küme, konteynere bir SIGTERM sinyali gönderir.

  4. Sistem, konteynerin durmasını veya bekleme süresinin (terminationGracePeriodSeconds, varsayılan: 30 saniye) dolmasını bekler.

  5. Bekleme süresi dolduktan sonra pod hâlâ çalışıyorsa kubelet 2 saniye daha bekler ve bir SIGKILL sinyali gönderir.

  6. Pod silinir.

Trafik yönlendirme kuralı güncelleme işlemi

  1. kube-apiserver, pod'u Terminating olarak işaretler.

  2. Endpoint controller, pod'un IP adresini endpoint'ten kaldırır.

  3. ALB Ingress controller, arka uç sunucularını uzlaştırır ve Service endpoint'ini arka uç sunucu grubundan kaldırır.

Her iki işlem de paralel çalıştığından ALB Ingress controller, pod kapanmadan önce uzlaştırmayı tamalayamayabilir ve trafiği sonlandırılan bir poda yönlendirebilir.

preStop hook hataları nasıl önler

preStop hook olmadan güncelleme sırasında şu hatalar oluşabilir:

Durum kodu Neden
504 Pod sonlandırıldığında idempotent olmayan bir isteği işliyordu.
502 Pod, SIGTERM aldıktan sonra kapandı ancak ALB Ingress controller henüz onu arka uç sunucu grubundan kaldırmamıştı.

Bir preStop hook, kube-apiserver pod'u Terminating olarak işaretlediğinde başlayan bir uyku gecikmesi ekler; bu sayede ALB Ingress controller, pod SIGTERM almadan önce pod'u kayıt dışı bırakmak için zaman kazanır.

Zaman bütçesi

preStop uyku süresi ile konteyner kapatma işlemi aynı bekleme süresini (terminationGracePeriodSeconds) paylaşır. sleep 10 ve 5 saniyelik program kapatma süresi durumunda terminationGracePeriodSeconds değerini en az 15 olarak ayarlayın ve bir güvenlik payı ekleyin. Bu konuda sleep 10 ve terminationGracePeriodSeconds: 45 kullanılmaktadır.

preStop süresi artı program kapatma süresi terminationGracePeriodSeconds değerini aşarsa sorunsuz kapatma zaman aşımına uğrar ve kubelet 2 saniyelik bir beklemeden sonra SIGKILL gönderir. Her ikisini de kapsayacak şekilde terminationGracePeriodSeconds değerini artırın.

Adım 1: preStop hook ile uygulamayı dağıtın

  1. Aşağıdaki içeriğe sahip tea-service.yaml dosyasını oluşturun. lifecycle.preStop alanı hook'u yapılandırır.

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: tea
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: tea
      template:
        metadata:
          labels:
            app: tea
        spec:
          containers:
          - name: tea
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
            ports:
            - containerPort: 80
            lifecycle:
              preStop:          # Delay SIGTERM by 10 seconds to allow the ALB Ingress controller
                exec:           # to finish deregistering the pod from the backend server group.
                  command:
                  - /bin/sh
                  - -c
                  - "sleep 10"
          terminationGracePeriodSeconds: 45   # Must exceed preStop duration + program shutdown time.
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: tea-svc
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: tea
      type: NodePort
  2. Deployment ve Service'i dağıtın.

    kubectl apply -f tea-service.yaml
  3. Aşağıdaki içeriğe sahip tea-ingress.yaml dosyasını oluşturun.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: tea-ingress
    spec:
      ingressClassName: alb
      rules:
      - host: demo.ingress.top
        http:
          paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: tea-svc
                port:
                  number: 80
  4. Ingress'i oluşturun.

    kubectl apply -f tea-ingress.yaml
  5. Ingress için ALB adresini alın.

    kubectl get ingress

    Beklenen çıktı:

    NAME          CLASS   HOSTS              ADDRESS                                              PORTS   AGE
    tea-ingress   alb     demo.ingress.top   alb-110zvs5nhsvfv*****.cn-chengdu.alb.aliyuncs.com   80      7m5s

    Sonraki adım için ADDRESS değerini not edin.

Adım 2: preStop hook'un hizmet kesintilerini önlediğini doğrulayın

  1. Aşağıdaki içeriğe sahip test.sh dosyasını oluşturun. Betik, saniyede bir istek gönderir ve her HTTP durum kodunu günlüğe kaydeder.

    #!/bin/bash
    HOST="demo.ingress.top"
    DNS="alb-110zvs5nhsvfv*****.cn-chengdu.alb.aliyuncs.com"  # Replace with your ADDRESS value.
    printf "Response Code|| TIME \n" >> log.txt
    
    while true; do
      RESPONSE=$(curl -H Host:$HOST -s -o /dev/null -w "%{http_code}" -m 1 http://$DNS/)
      TIMESTAMP=$(date +%Y-%m-%d_%H:%M:%S)
      echo "$TIMESTAMP - $RESPONSE" >> log.txt
      sleep 1
    done
  2. Betik çalıştırın.

    bash test.sh
  3. Yuvarlanarak yeniden başlatmayı tetikleyin.

    kubectl rollout restart deploy tea
  4. Güncelleme ilerlemesini izleyin. Aşağıdaki ekran görüntüleri, güncelleme sırasındaki her aşama için beklenen pod durumlarını göstermektedir.

    image

    image

    image

    image

  5. Test günlüğünü kontrol edin. Tüm isteklerin 200 döndürmesi, hizmet kesintisi olmadığını doğrular.

    cat log.txt

    Beklenen çıktı:

    image

Sonraki adımlar