Container Service for Kubernetes:preStop フックを使用して、ALB Ingress のローリングアップデート中の 502/504 エラーを防ぐ

前提条件

始める前に、以下を確認してください。

• Kubernetes 1.18 以降を実行している ACK マネージドクラスターまたは ACK 専用クラスター (提供終了) があること。アップグレードについては、「ACK クラスターの手動アップグレード」をご参照ください。

• クラスターに ALB Ingress controller がインストールされていること。

ACK 専用クラスターで ALB Ingress を使用するには、まず ALB Ingress controller 用にクラスターを認可する必要があります。

仕組み

Pod のライフサイクル

Pod には 2 種類のコンテナが含まれます。

• Init コンテナ：初期化のために、メインコンテナの前に実行されます。

• メインコンテナ：アプリケーションを実行します。起動後に postStart フックが実行され、コンテナの存続期間中は liveness チェックと readiness チェックが実行され、終了前に preStop フックが実行されます。

次の図は、Pod のライフサイクルを示しています。

ステップ 1：preStop フックを使用してアプリケーションをデプロイする

1. 以下の内容で tea-service.yaml を作成します。lifecycle.preStop フィールドでフックを設定します。

   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:          # ALB Ingress controller がバックエンドサーバーグループから
               exec:           # Pod の登録解除を完了できるように、SIGTERM を 10 秒遅延させます。
                 command:
                 - /bin/sh
                 - -c
                 - "sleep 10"
         terminationGracePeriodSeconds: 45   # preStop の実行時間 + プログラムのシャットダウン時間を超える必要があります。
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: tea-svc
   spec:
     ports:
     - port: 80
       targetPort: 80
       protocol: TCP
     selector:
       app: tea
     type: NodePort

2. Deployment と Service をデプロイします。

   kubectl apply -f tea-service.yaml

3. 次の内容で tea-ingress.yaml を作成します。

   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 を作成します。

   kubectl apply -f tea-ingress.yaml

5. Ingress の ALB アドレスを取得します。

   kubectl get ingress

   出力例：

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

   次のステップで使用する ADDRESS の値をメモしておいてください。

ステップ 2：preStop フックがサービス中断を防ぐことを検証する

1. 以下の内容で test.sh を作成します。このスクリプトは、1 秒に 1 回リクエストを送信し、各 HTTP ステータスコードをログに記録します。

   #!/bin/bash
   HOST="demo.ingress.top"
   DNS="alb-110zvs5nhsvfv*****.cn-chengdu.alb.aliyuncs.com"  # 実際の ADDRESS の値に置き換えてください。
   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. スクリプトを実行します。

   bash test.sh

3. ローリング再起動をトリガーします。

   kubectl rollout restart deploy tea

4. ロールアウトの進行状況を監視します。次のスクリーンショットは、更新の各フェーズで予想される Pod の状態を示しています。

   

   

   

   

5. テストログを確認します。すべてのリクエストが 200 を返すことで、サービスが中断されなかったことが確認できます。

   cat log.txt

   出力例：

   

次のステップ

• HTTP から HTTPS へのリダイレクトやカナリアリリースなどの高度なルーティングについては、「ALB Ingress の高度な設定」をご参照ください。

• ローリングアップデート中に、トラフィックを受信する前に Pod が readiness チェックに合格するようにするには、「Readiness Gate を使用して、ALB Ingress に関連付けられた Pod のローリングアップデート中にシームレスな起動を実現する」をご参照ください。

• 問題が発生した場合は、「ALB Ingress のよくある質問」および「ALB Ingress controller のトラブルシューティング」をご参照ください。