Alibaba Cloud Service Mesh:トラフィックレーンを用いたエンドツーエンドカナリアリリース

自動サイドカープロキシ注入の有効化

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

2. Mesh Management ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションウィンドウで、ASM Instance ＞ Global Namespace を選択します。

3. Global Namespace ページで、default 名前空間を見つけ、Automatic Sidecar Injection 列の Enable Automatic Sidecar Injection をクリックします。Submit メッセージで、OK をクリックします。

詳細については、「自動サイドカープロキシ注入の有効化」をご参照ください。

サービスのデプロイ

ACK クラスター内で、サンプルサービスの v1、v2、v3 をデプロイします。

kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v1/application-v1.yaml
kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v2/application-v2.yaml
kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v3/application-v3.yaml

レーングループの作成

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

2. Mesh Management ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションウィンドウで、Traffic Management Center ＞ Traffic Lane を選択します。

3. Traffic Lane ページで、Create Swimlane Group をクリックします。Create Swimlane Group パネルで、以下のパラメーターを設定し、OK をクリックします。

パラメーター	値
Swim lane group の名前	test
入口ゲートウェイ	ingressgateway
Swimlane Services	Kubernetes Clusters ドロップダウンリストから ACK クラスターを選択し、名前空間ドロップダウンリストから default を選択します。サービス一覧から mocka、mockb、mockc を選択し、 アイコンをクリックして selected セクションに追加します

レーングループを作成すると、ASM により TrafficLabel リソースが自動生成されます。

apiVersion: istio.alibabacloud.com/v1beta1
kind: TrafficLabel
metadata:
  labels:
    asm-system: 'true'
    provider: asm
  name: asm-trafficlabel-global
  namespace: istio-system
spec:
  rules:
    - labels:
        - name: asm-label
          valueFrom:
            - $getLabel(ASM_TRAFFIC_TAG)   # 各 Pod の ASM_TRAFFIC_TAG ラベルを読み取ります

レーンの作成

3 つのレーン（s1、s2、s3）を作成し、それぞれに対応するサービスバージョンを紐付けます。以下は s1 レーンの作成手順です。s2（サービスタグ：v2）、s3（サービスタグ：v3）についても同様の手順を繰り返します。

1. Traffic Lane ページの Traffic Rule Definition セクションで、Create swimlanes をクリックします。

2. Create swimlanes ダイアログボックスで、以下のパラメーターを設定し、OK をクリックします。

3 つのレーンの作成が完了すると、Traffic Rule Definition セクションに以下のように表示されます。

各レーンの作成時に DestinationRule が生成されます。以下は s1 レーンの DestinationRule の例です。

apiVersion: networking.istio.io/v1beta1
kind: DestinationRule
metadata:
  labels:
    asm-system: 'true'
    provider: asm
    swimlane-group: test                              # 「test」レーングループに属する
  name: trafficlabel-dr-test-default-mocka
  namespace: istio-system
spec:
  host: mocka.default.svc.cluster.local               # 対象サービス
  subsets:
    - labels:
        ASM_TRAFFIC_TAG: v1                            # レーン s1 はバージョン v1 にマップ
      name: s1
    - labels:
        ASM_TRAFFIC_TAG: v1
      name: v1
    - labels:
        ASM_TRAFFIC_TAG: v2                            # レーン s2 はバージョン v2 にマップ
      name: v2
    - labels:
        ASM_TRAFFIC_TAG: v2
      name: s2
    - labels:
        ASM_TRAFFIC_TAG: v3                            # レーン s3 はバージョン v3 にマップ
      name: v3
    - labels:
        ASM_TRAFFIC_TAG: v3
      name: s3

イングレストラフィックルールの作成

各レーンに対してトラフィックルーティングルールを作成します。以下は s1 レーンのルール作成手順です。s2 および s3 についても同様の手順を繰り返します。

本例では、すべてのレーンサービスがインバウンドリクエストパス /mock を共有していると仮定します。

1. Traffic Lane ページの Traffic Rule Definition セクションで、対象のレーンを見つけ、Actions 列の Ingress traffic rules をクリックします。

2. Add drainage rule ダイアログボックスで、以下のパラメーターを設定し、OK をクリックします。

3 つのレーンすべてに対するトラフィックルーティングルールを作成すると、Traffic Rule Definition セクションに以下のように表示されます。

ASM は、x-asm-prefer-tag ヘッダーに基づいてリクエストをルーティングする VirtualService を生成します。

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  labels:
    asm-system: 'true'
    istioGateway: ingressgateway
    provider: asm
  name: ingressgateway
  namespace: istio-system
spec:
  gateways:
    - istio-system/ingressgateway                      # イングレスゲートウェイにバインド
  hosts:
    - '*'                                              # すべてのホストと一致
  http:
    - match:
        - headers:
            x-asm-prefer-tag:
              exact: s1                                # レーン s1 用にタグ付けされたリクエストと一致
          uri:
            exact: /mock                               # /mock パスと一致
      name: swimelane-ingress-route-test-s1-rule1
      route:
        - destination:
            host: mocka.default.svc.cluster.local      # mocka にルーティング
            subset: s1                                 # s1 サブセット（バージョン v1）を使用
    - match:
        - headers:
            x-asm-prefer-tag:
              exact: s2                                # レーン s2 用にタグ付けされたリクエストと一致
          uri:
            exact: /mock
      name: swimelane-ingress-route-test-s2-rule2
      route:
        - destination:
            host: mocka.default.svc.cluster.local
            subset: s2                                 # s2 サブセット（バージョン v2）を使用
    - match:
        - headers:
            x-asm-prefer-tag:
              exact: s3                                # レーン s3 用にタグ付けされたリクエストと一致
          uri:
            exact: /mock
      name: swimelane-ingress-route-test-s3-rule3
      route:
        - destination:
            host: mocka.default.svc.cluster.local
            subset: s3                                 # s3 サブセット（バージョン v3）を使用

ゲートウェイ IP アドレスの取得

ASM イングレスゲートウェイのパブリック IP アドレスを取得します。詳細については、「クラウドネイティブ推論サービス KServe と ASM の統合」のステップ 2 をご参照ください。

IP アドレスを環境変数として設定します。<gateway-ip-address> を実際のパブリック IP アドレスに置き換えます。

export ASM_GATEWAY_IP=<gateway-ip-address>

各レーンのテスト

各レーンに 100 回のリクエストを送信し、トラフィックが期待されるサービスバージョン内に留まっていることを確認します。

レーン s1（期待結果：すべて v1）：

for i in {1..100}; do curl -H 'x-asm-prefer-tag: s1' http://${ASM_GATEWAY_IP}/mock; echo ''; sleep 1; done;

期待される出力：

-> mocka(version: v1, ip: 172.17.0.54)-> mockb(version: v1, ip: 172.17.0.129)-> mockc(version: v1, ip: 172.17.0.130)

3 つのサービスすべてが v1 を返すため、x-asm-prefer-tag: s1 でタグ付けされたリクエストが s1 レーン内でのみルーティングされることを確認できます。

レーン s2（期待結果：すべて v2）：

for i in {1..100}; do curl -H 'x-asm-prefer-tag: s2' http://${ASM_GATEWAY_IP}/mock; echo ''; sleep 1; done;

期待される出力：

-> mocka(version: v2, ip: 172.17.0.9)-> mockb(version: v2, ip: 172.17.0.126)-> mockc(version: v2, ip: 172.17.0.128)

レーン s3（期待結果：すべて v3）：

for i in {1..100}; do curl -H 'x-asm-prefer-tag: s3' http://${ASM_GATEWAY_IP}/mock; echo ''; sleep 1; done;

期待される出力：

-> mocka(version: v3, ip: 172.17.0.132)-> mockb(version: v3, ip: 172.17.0.127)-> mockc(version: v3, ip: 172.17.0.69)

ルーティング問題のトラブルシューティング

いずれかのリクエストで不正なバージョンが返された場合、以下の項目を確認してください。