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

Pré-requisitos

Antes de começar, verifique se você possui:

• Um cluster gerenciado ACK ou cluster dedicado ACK (descontinuado) executando Kubernetes 1.18 ou posterior. Para fazer upgrade, consulte Fazer upgrade manual de clusters ACK.

• O controlador do ALB Ingress instalado no cluster.

Para usar um ALB Ingress com um cluster dedicado ACK, autorize o cluster para o controlador do ALB Ingress primeiro.

Como funciona

Etapa 1: Implantar a aplicação com um hook preStop

1. Crie o arquivo tea-service.yaml com o conteúdo abaixo. O campo lifecycle.preStop configura o 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. Implante o Deployment e o Service.

   kubectl apply -f tea-service.yaml

3. Crie o arquivo tea-ingress.yaml com o conteúdo a seguir.

   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. Crie o Ingress.

   kubectl apply -f tea-ingress.yaml

5. Obtenha o endereço do ALB para o Ingress.

   kubectl get ingress

   Saída esperada:

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

   Anote o valor de ADDRESS para a próxima etapa.

Etapa 2: Verificar se o hook preStop evita interrupções de serviço

1. Crie o arquivo test.sh com o conteúdo seguinte. O script envia uma requisição por segundo e registra cada código de status 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. Execute o script.

   bash test.sh

3. Acione uma reinicialização contínua.

   kubectl rollout restart deploy tea

4. Acompanhe o progresso da atualização. As capturas de tela a seguir mostram os estados esperados dos pods durante cada fase da atualização.

   

   

   

   

5. Verifique o log de teste. Todas as requisições devem retornar 200, confirmando zero interrupções de serviço.

   cat log.txt

   Saída esperada:

   

Próximas etapas

• Para roteamento avançado — como redirecionamentos de HTTP para HTTPS e lançamentos canário — consulte Configurações avançadas do ALB Ingress.

• Para garantir que os pods passem nas verificações de prontidão antes de receber tráfego durante atualizações contínuas, veja Usar readiness gates para lançar continuamente pods associados a ALB Ingresses.

• Caso enfrente problemas, consulte as Perguntas frequentes sobre ALB Ingress e o guia de Solução de problemas do controlador do ALB Ingress.