Container Service for Kubernetes:Kruise Rollout を使用した段階的リリースの実装

ステップ 1: ack-kruise アドオンのインストール

1. ACK コンソールにログオンします。左側のナビゲーションペインで、[クラスター]を選択します。

2. [クラスター] ページで、目的のクラスターの名前をクリックします。左側のナビゲーションペインで、[アドオン] をクリックします。

3. [アドオン] ページで、[アプリケーション管理] タブをクリックします。[ack-kruise] カードで、[インストール] をクリックします。

4. ダイアログボックスで、[OK] をクリックします。

ack-kruise アドオン 1.8 以降は v1beta1 API をサポートします。詳細については、「API 仕様」をご参照ください。

ステップ 2: サンプルアプリケーションのデプロイ

デプロイメントとサービスを使用して echoserver サービスをデプロイします。echoserver サービスをデプロイメントとイングレスを使用してデプロイします。このサンプルは、両方のユースケースで使用されます。

1. echoserver.yaml という名前のファイルを作成します。

   YAML コンテンツを表示するには展開してください

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: echoserver
     labels:
       app: echoserver
   spec:
     replicas: 6
     selector:
       matchLabels:
         app: echoserver
     template:
       metadata:
         labels:
           app: echoserver
       spec:
         containers:
         - name: echoserver
           image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.2
           imagePullPolicy: IfNotPresent
           ports:
           - containerPort: 8080
           env:
           - name: NODE_NAME
             value: version1
           - name: PORT
             value: '8080'
           - name: POD_NAME
             valueFrom:
               fieldRef:
                 fieldPath: metadata.name
           - name: POD_NAMESPACE
             valueFrom:
               fieldRef:
                 fieldPath: metadata.namespace
           - name: POD_IP
             valueFrom:
               fieldRef:
                 fieldPath: status.podIP
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: echoserver
     labels:
       app: echoserver
   spec:
     ports:
     - port: 80
       targetPort: 8080
       protocol: TCP
       name: http
     selector:
       app: echoserver

2. 構成を適用します。

   kubectl apply -f echoserver.yaml

ステップ 1: Ingress コントローラーのインストールと Ingress の作成

Ingress タイプを選択し、対応する手順に従ってください。

ステップ 2: アプリケーションへのアクセスの確認

1. 外部 IP アドレスまたはホスト名を取得します。Nginx Ingress：

   export EXTERNAL_IP=$(kubectl get ingress echoserver -o jsonpath="{.status.loadBalancer.ingress[0].ip}")

   MSE Ingress：

   export EXTERNAL_IP=$(kubectl get ingress echoserver -o jsonpath="{.status.loadBalancer.ingress[0].hostname}")

2. アクセスをテストします。

   curl http://${EXTERNAL_IP}/apis/echo

   想定される出力：

   Hostname: echoserver-75d49c475c-ls2bs
   
   Pod Information:
       node name:    version1
       pod name:    echoserver-75d49c475c-ls2bs
       pod namespace:    default
   
   Server values:
       server_version=nginx: 1.13.3 - lua: 10008
   ...

ステップ 3: Rollout リソースの定義

ユースケースに応じた戦略で rollout.yaml という名前のファイルを作成します。trafficRoutings フィールドは、各ステップでトラフィックをシフトするために、Rollout を echoserver Service と Ingress にリンクします。

apiVersion: rollouts.kruise.io/v1alpha1
kind: Rollout
metadata:
  name: rollouts-demo
spec:
  objectRef:
    workloadRef:
      apiVersion: apps/v1
      kind: Deployment
      name: echoserver
  strategy:
    canary:
      steps:
      # ステップ 1: トラフィックの 20% を新バージョン (Pod 1 つ) にルーティングします。手動承認まで一時停止します。
      - weight: 20
        replicas: 1
        pause: {}
      # ステップ 2: トラフィック 50%、Pod 50% に増やします。60 秒後に自動的に進行します。
      - weight: 50
        replicas: 50%
        pause: {duration: 60}  # 単位: 秒
      # ステップ 3: 完全リリース。
      - weight: 100
        replicas: 100%
        pause: {duration: 60}  # 単位: 秒
      trafficRoutings:
      - service: echoserver
        ingress:
          name: echoserver

apiVersion: rollouts.kruise.io/v1alpha1
kind: Rollout
metadata:
  name: rollouts-demo
spec:
  objectRef:
    workloadRef:
      apiVersion: apps/v1
      kind: Deployment
      name: echoserver
  strategy:
    canary:
      steps:
      # ステップ 1: Android トラフィックを新バージョン (Pod 1 つ) にルーティングします。手動承認まで一時停止します。
      - matches:
          - headers:
              - type: Exact
                name: User-Agent
                value: Android
        pause: {}
        replicas: 1
      # ステップ 2: Pod 50%、引き続き Android トラフィックをマッチングします。60 秒後に自動的に進行します。
      - matches:
          - headers:
              - type: Exact
                name: User-Agent
                value: Android
        pause: {duration: 60}  # 単位: 秒
        replicas: 50%
      # ステップ 3: 完全リリース。
      - matches:
          - headers:
              - type: Exact
                name: User-Agent
                value: Android
        pause: {duration: 60}  # 単位: 秒
        replicas: 100%
      trafficRoutings:
        - service: echoserver
          ingress:
            name: echoserver

kubectl apply -f rollout.yaml
kubectl get rollout

NAME            STATUS    CANARY_STEP   CANARY_STATE   MESSAGE                            AGE
rollouts-demo   Healthy   3             Completed      workload deployment is completed   7s

ステップ 4: アップグレードのトリガー

Kruise Rollout は、Deployment 仕様が変更されると自動的に開始されます。echoserver.yaml のイメージバージョンを更新してリリースをトリガーします。

# echoserver.yaml (関連セクション)
spec:
  containers:
  - name: echoserver
    image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.3
    env:
    - name: NODE_NAME
      value: version2  # オプション: 検証出力で新バージョンを識別するのに役立ちます

更新された Deployment を適用します。Helm や Vela などのツールも使用できます。

kubectl apply -f echoserver.yaml

ロールアウトのステータスを確認します。

kubectl get rollouts rollouts-demo -n default

想定される出力：

NAME            STATUS        CANARY_STEP   CANARY_STATE   MESSAGE                                                                         AGE
rollouts-demo   Progressing   1             StepPaused     Rollout is in step(1/3), and you need manually confirm to enter the next step   41m

ステータスフィールドの意味：

ステップ 5: トラフィック分散の確認と進行

リリースのロールバック

いずれかのステップで新バージョンが意図しない動作をした場合は、以前の Deployment 構成を復元して再適用します。Rollout リソースの変更は不要です。

# echoserver.yaml (ロールバックバージョン)
spec:
  containers:
  - name: echoserver
    image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.2
    env:
    - name: NODE_NAME
      value: version1

kubectl apply -f echoserver.yaml

ステップ 1: Rollout リソースの定義とデプロイ

この Rollout は partition ローリングスタイルを使用して、Pod を 3 つのバッチ (1 Pod、次に 50%、最後に 100%) でリリースします。マイクロサービスフレームワークがトラフィックを管理するため、trafficRoutings フィールドは省略されています。

# rollout.yaml として保存
apiVersion: rollouts.kruise.io/v1alpha1
kind: Rollout
metadata:
  name: rollouts-demo
  annotations:
    rollouts.kruise.io/rolling-style: partition
spec:
  objectRef:
    workloadRef:
      apiVersion: apps/v1
      kind: Deployment
      name: echoserver
  strategy:
    canary:
      steps:
      # ステップ 1: Pod 1 つを更新します。手動承認まで一時停止します。
      - replicas: 1
        pause: {}
      # ステップ 2: Pod の 50% を更新します。60 秒後に自動的に進行します。
      - replicas: 50%
        pause: {duration: 60}  # 単位: 秒
      # ステップ 3: すべての Pod を更新します。
      - replicas: 100%
        pause: {duration: 60}  # 単位: 秒

kubectl apply -f rollout.yaml

ステップ 2: アップグレードのトリガー

echoserver.yaml のイメージバージョンを更新します。

# echoserver.yaml (関連セクション)
spec:
  containers:
  - name: echoserver
    image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.3
    env:
    - name: NODE_NAME
      value: version2  # オプション: 新バージョンの識別に役立ちます

kubectl apply -f echoserver.yaml

ステップ 3: ロールアウトステータスの確認

kubectl get rollouts rollouts-demo -n default

想定される出力：

NAME            STATUS        CANARY_STEP   CANARY_STATE   MESSAGE                                                                         AGE
rollouts-demo   Progressing   1             StepPaused     Rollout is in step(1/3), and you need manually confirm to enter the next step   41m

ステップ 4: バッチの承認と進行状況の監視

ステップ 1 を承認してステップ 2 に進みます。

kubectl-kruise rollout approve rollouts/rollouts-demo -n default

ロールアウトを監視します。

kubectl get rollouts rollouts-demo -n default -w

承認後、ロールアウトはステップ 2 (Pod 50%、一時停止 60 秒) とステップ 3 (すべての Pod、一時停止 60 秒) を進みます。主要な状態遷移：

STATUS=Healthy かつ CANARY_STATE=Completed になると、ロールアウトは完了です。

リリースのロールバック

新バージョンが意図しない動作をした場合は、以前の Deployment 構成を復元して再適用します。Rollout リソースの変更は不要です。

# echoserver.yaml (ロールバックバージョン)
spec:
  containers:
  - name: echoserver
    image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.2
    env:
    - name: NODE_NAME
      value: version1

kubectl apply -f echoserver.yaml