Alibaba Cloud Service Mesh:ASM と Argo Rollouts を統合したカナリアリリースの実装

ステップ 1：Rollout とサービスの作成

ステップ 2：Istio リソースの作成

データプレーンの KubeAPI アクセスが有効になっている場合、データプレーンクラスターから kubectl を使用して Istio リソースを直接作成できます。または、ASM コンソールまたはコントロールプレーンの kubeconfig を使用することもできます。

ステップ 3：イングレスゲートウェイのデプロイ

サービスアクセス用にポート 80 が有効になっている ASM イングレスゲートウェイを作成します。

1. ASM コンソールにログインします。左側のナビゲーションウィンドウで、[Service Mesh] ＞ [メッシュ管理] を選択します。

2. [メッシュ管理] ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションウィンドウで、[ASM ゲートウェイ] ＞ [Ingress ゲートウェイ] を選択します。

3. 「[Ingress ゲートウェイ]」ページで、[作成] をクリックし、以下のパラメーターを設定します。その他のパラメーターについては、「Ingress ゲートウェイの作成」をご参照ください。

   パラメーター	値
   名前	ingressgateway
   ゲートウェイタイプ	North-South IngressGateway
   ポートマッピング	プロトコル：HTTP、サービスポート：80

4. 「[作成]」をクリックします。

ステップ 4：初期 Rollout ステータスの確認

次のコマンドを実行して、Rollout が正常であることを確認します。

kubectl argo rollouts get rollout istio-rollout --watch

期待される出力：

Name:            istio-rollout
Namespace:       default
Status:           Healthy
Strategy:        Canary
  Step:          18/18
  SetWeight:     100
  ActualWeight:  100
Images:          argoproj/rollouts-demo:blue (stable)
Replicas:
  Desired:       1
  Current:       1
  Updated:       1
  Ready:         1
  Available:     1

NAME                                       KIND        STATUS     AGE  INFO
⟳ istio-rollout                            Rollout      Healthy  52s
└──# revision:1
└──⧉ istio-rollout-7f96d86486           ReplicaSet   Healthy  52s  stable
   └──□ istio-rollout-7f96d86486-vpqvb  Pod         Running  52s  ready:2/2

ステータスが Healthy で、イメージが argoproj/rollouts-demo:blue (stable) であることは、初期デプロイメントが成功したことを示します。

ステップ 5：初期デプロイメントのテスト

1. イングレスゲートウェイの IP アドレスを取得します。

   1. ASM コンソールにログインします。 左側のナビゲーションウィンドウで、[Service Mesh] > [メッシュ管理] を選択します。

   2. ASM インスタンス名をクリックします。左側のナビゲーションウィンドウで、ASM ゲートウェイ ＞ Ingress ゲートウェイ を選択します。

   3. イングレスゲートウェイの [サービスアドレス] をコピーします。

2. ブラウザで http://<ingress-gateway-ip>/ を開きます。ページは /color を同時に呼び出し、返された色でグリッドを塗りつぶします。安定版は blue イメージを使用しており、カナリア版は実行されていないため、すべてのグリッドが青色で表示されます。

   

ステップ 6：カナリアリリースの実行

この例では、黄色がカナリア版を表します。リリースが進行するにつれて、グリッドは徐々に青から黄色に変わります。

最初のトラフィックシフトの観測

ブラウザで http://<ingress-gateway-ip>/ を開きます。グリッドの約 10% が黄色で表示されるようになります。Argo Rollouts コントローラーは VirtualService の重みを更新し、安定版 (青) は 100 から 90 に、カナリア版 (黄) は 0 から 10 に変更されました。

最初のステップでは持続時間なしの pause: {} が指定されているため、Rollout は次に進む前に手動承認を待ちます。

ステップ 1：ASM で Prometheus を有効化

ASM インスタンスの Prometheus モニタリングを有効にします。詳細については、以下をご参照ください。

• Managed Service for Prometheus と連携した ASM インスタンスのモニタリング

• セルフマネージド Prometheus インスタンスを使用した ASM インスタンスのモニタリング

ステップ 2：AnalysisTemplate の作成

AnalysisTemplate は、カナリア版のリクエスト成功率を計算する Prometheus クエリを定義します。成功率が 0.90 以下に低下した場合 (つまり、リクエストの 10% 以上が 5xx エラーを返す場合)、Rollout は Degraded とマークされ、自動的にロールバックされます。

1. 次の内容で istio-success-rate.yaml ファイルを作成します。<your-prometheus-endpoint> を、ASM に接続されている Prometheus インスタンスの実際のエンドポイントに置き換えてください。

   apiVersion: argoproj.io/v1alpha1
   kind: AnalysisTemplate
   metadata:
     name: istio-success-rate
   spec:
     args:
     - name: service                       # Service name, passed from the Rollout
     - name: namespace                     # Namespace, auto-resolved from the Rollout
     metrics:
     - name: success-rate
       initialDelay: 60s                   # Wait 60s for traffic to flow before first check
       interval: 20s                       # Re-evaluate every 20 seconds
       successCondition: result[0] > 0.90  # Pass if success rate > 90%; fail otherwise
       provider:
         prometheus:
           address: http://<your-prometheus-endpoint>:9090/api/v1/prometheus/
           query: >+
             sum(irate(istio_requests_total{
               reporter="source",
               destination_service=~"{{args.service}}.{{args.namespace}}.svc.cluster.local",
               response_code!~"5.*"}[40s])
             )
             /
             sum(irate(istio_requests_total{
               reporter="source",
               destination_service=~"{{args.service}}.{{args.namespace}}.svc.cluster.local"}[40s])
             )

2. AnalysisTemplate をデプロイします。

   kubectl apply -f istio-success-rate.yaml

ステップ 3：AnalysisTemplate と Rollout の関連付け

Rollout を更新して、AnalysisTemplate を参照する analysis セクションを含めます。分析は 2 番目のステップ (startingStep: 1) から開始され、メトリックが評価される前にカナリア版がトラフィックを受信する時間を確保します。

1. 次の内容で新しい rollout.yaml ファイルを作成します。

   rollout.yaml の表示

   apiVersion: argoproj.io/v1alpha1
   kind: Rollout
   metadata:
     name: istio-rollout
   spec:
     revisionHistoryLimit: 2
     selector:
       matchLabels:
         app: istio-rollout
     template:
       metadata:
         annotations:
           sidecar.istio.io/inject: "true"
         labels:
           app: istio-rollout
       spec:
         containers:
         - name: istio-rollout
           image: argoproj/rollouts-demo:yellow   # Current stable version
           ports:
           - name: http
             containerPort: 8080
             protocol: TCP
           resources:
             requests:
               memory: 32Mi
               cpu: 5m
     strategy:
       canary:
         canaryService: istio-rollout-canary
         stableService: istio-rollout-stable
         analysis:
           startingStep: 1                        # Start analysis from the second step
           templates:
           - templateName: istio-success-rate     # Reference the AnalysisTemplate
           args:
           - name: service
             value: canary
           - name: namespace
             valueFrom:
               fieldRef:
                 fieldPath: metadata.namespace    # Auto-resolve namespace
         trafficRouting:
           istio:
             virtualService:
               name: istio-rollout-vsvc
               routes:
               - primary
         steps:
         - setWeight: 10
         - pause: {}              # Wait for manual approval
         - setWeight: 20
         - pause: {duration: 20s}
         - setWeight: 30
         - pause: {duration: 20s}
         - setWeight: 40
         - pause: {duration: 20s}
         - setWeight: 50
         - pause: {duration: 20s}
         - setWeight: 60
         - pause: {duration: 20s}
         - setWeight: 70
         - pause: {duration: 20s}
         - setWeight: 80
         - pause: {duration: 20s}
         - setWeight: 90
         - pause: {duration: 20s}

2. Rollout を更新します。

   kubectl apply -f rollout.yaml

ステップ 4：分析付きカナリアリリースのトリガー

1. イメージを更新して、新しいカナリアリリースを開始します。ブラウザで http://<ingress-gateway-ip>/ を開きます。カナリアトラフィックが流れると、オレンジ色のグリッドが表示され始めます。

   kubectl argo rollouts set image istio-rollout "*=argoproj/rollouts-demo:orange"

   

2. Rollout を承認して、Prometheus モニタリングによる自動カナリア進行を開始します。

   kubectl argo rollouts promote istio-rollout

3. Rollout のステータスを監視します。

   kubectl argo rollouts get rollout istio-rollout --watch

   

ステップ 5：自動ロールバックのテスト

ロールバックの動作をテストするには、デモアプリケーションページのエラー率スライダーを使用して、カナリア版のエラー率を上げます。エラー率が 10% を超える (成功率が 0.90 を下回る) と、AnalysisTemplate は Rollout を Degraded とマークし、コントローラーは自動的に安定版 (黄) にロールバックします。

短い遅延の後、すべてのトラフィックが安定版に戻ります。