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

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un cluster ACK managé ou un cluster ACK dédié (obsolète) exécutant Kubernetes 1.18 ou une version ultérieure. Pour mettre à niveau, consultez la rubrique Mettre à niveau manuellement les clusters ACK.

• Le contrôleur ALB Ingress est installé dans le cluster.

Pour utiliser un ALB Ingress avec un cluster ACK dédié, autorisez le cluster pour le contrôleur ALB Ingress au préalable.

Fonctionnement

Étape 1 : Déployer l'application avec un hook preStop

1. Créez le fichier tea-service.yaml avec le contenu suivant. Le champ lifecycle.preStop configure le hook.

   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. Déployez le Deployment et le Service.

   kubectl apply -f tea-service.yaml

3. Créez le fichier tea-ingress.yaml avec le contenu suivant.

   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. Créez l'Ingress.

   kubectl apply -f tea-ingress.yaml

5. Récupérez l'adresse ALB de l'Ingress.

   kubectl get ingress

   Résultat attendu :

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

   Notez la valeur ADDRESS pour l'étape suivante.

Étape 2 : Vérifier que le hook preStop empêche les interruptions de service

1. Créez le fichier test.sh avec le contenu suivant. Ce script envoie une requête par seconde et consigne chaque code d'état HTTP.

   #!/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. Exécutez le script.

   bash test.sh

3. Déclenchez un redémarrage progressif.

   kubectl rollout restart deploy tea

4. Surveillez la progression du déploiement. Les captures d'écran suivantes montrent les états attendus des pods durant chaque phase de la mise à jour.

   

   

   

   

5. Vérifiez le journal de test. Toutes les requêtes doivent retourner le code 200, confirmant l'absence d'interruption de service.

   cat log.txt

   Résultat attendu :

   

Étapes suivantes

• Pour des configurations de routage avancées, telles que les redirections HTTP vers HTTPS et les versions Canary, consultez la rubrique Configurations avancées d'ALB Ingress.

• Pour garantir que les pods passent les vérifications de disponibilité (readiness) avant de recevoir du trafic lors des mises à jour progressives, consultez la rubrique Utiliser des portes de disponibilité pour lancer transparentement les pods associés aux ALB Ingresses lors des mises à jour progressives.

• En cas de problème, consultez la FAQ sur ALB Ingress et la rubrique Dépannage du contrôleur ALB Ingress.