新しいクラスタでクラスタ内 Istio に移行する

このチュートリアルでは、クラスタ内 Cloud Service Mesh を使用する既存の Google Kubernetes Engine(GKE)クラスタから、オープンソースの Istio を使用する新しい GKE クラスタにアプリケーションを移行する方法について説明します。 エッジからマルチクラスタ メッシュ の機能を利用して、シームレスな移行を実現します。

用語に関する注: このチュートリアルでは、Cloud Service Mesh は Google のクラスタ内 Cloud Service Mesh を指し、Istio はオープンソースの Istio サービス メッシュを指します。

このチュートリアルの内容は次のとおりです。

  1. 移行のために、クラスタ内 Cloud Service Mesh を使用して既存のクラスタを準備します。
  2. Istio を使用して新しい GKE クラスタをプロビジョニングします。
  3. 専用クラスタで GKE マルチクラスタ Gateway API を構成し、マルチクラスタ サービスを構成して、メッシュ Ingress へのルーティングを設定します。
  4. カナリア デプロイを実行して、Cloud Service Mesh と Istio の間でライブ HTTP トラフィックを分割します。
  5. Istio への最終的な切り替えを完了し、クラスタ内 Cloud Service Mesh リソースを廃止します。

カナリア デプロイ

カナリア デプロイとは、ソフトウェア工学で使用される手法の一つで、ソフトウェアやインフラストラクチャの新しいバージョンをすべての本番環境ユーザーにリリースする前にテストします。新しいターゲット バージョンに送信されるトラフィックの割合を段階的に増やします。

このチュートリアルでは、Istio を使用して新しいクラスタを設定し、ユーザー トラフィックを段階的に移行します。まず、ユーザー トラフィックの 0% を新しいクラスタに転送し、次に 50%、最後に 100% を Istio を使用する GKE クラスタに転送します。本番環境では、より細かく段階的に移行できます(1%、5%、10%、25%、50%、100% など)。新しいクラスタでエラーやパフォーマンスの低下が発生した場合は、Istio クラスタのトラフィックの割合を 0% に戻すことで、すぐにロールバックできます。

カナリア コントロール プレーンとカナリア クラスタ

サービス メッシュ コントロール プレーン間の移行には、主に次の 2 つの方法があります。

  • カナリア クラスタの移行(推奨): この方法では、既存のクラスタと同じ Google Cloud プロジェクトとフリートに新しい クラスタを作成し、ターゲット サービス メッシュ コントロール プレーン(Istio)をインストールして、ワークロードと Ingress トラフィックを新しいクラスタに移行します。
  • カナリア コントロール プレーンの移行(サポート対象外): この方法では、 初期コントロール プレーンがインストールされているのと同じクラスタに、新しいコントロール プレーンを並行してインストールします。この移行モードは対象外です。

このガイドでは、カナリア クラスタの移行方法について説明します。両方の クラスタが同じ Google Cloud プロジェクトに存在する必要があります。

費用

このチュートリアルでは、以下を含む、 Google Cloudの課金対象となるコンポーネントを使用します。

このチュートリアルを完了したら、作成したリソースを削除して継続的な費用が発生しないようにできます。詳細については、 クリーンアップをご覧ください。

始める前に

  1. Google Cloud コンソールのプロジェクト セレクタページで、クラスタ内 Cloud Service Mesh がインストールされている Google Cloud プロジェクト を選択します。

    プロジェクト セレクタに移動

  2. アカウントに Google Cloud ログインします。 を初めて使用する場合は、 Google Cloud、 アカウントを作成して、 実際のシナリオでプロダクトがどのように機能するかを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイに利用できる $300 分の無料クレジットも提供されます。
  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. Verify that billing is enabled for your Google Cloud project.

  6. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

移行のためにクラスタ内 Cloud Service Mesh を使用してクラスタを準備する

このセクションでは、クラスタ内 Cloud Service Mesh を実行している既存の GKE クラスタを、Istio を使用する GKE クラスタに移行する準備を行います。

クラスタ内 Cloud Service Mesh クラスタが実行されており、移行の準備ができていることを確認する

  1. クラスタ内 Cloud Service Mesh のインストール ガイドに沿って、クラスタ内 Cloud Service Mesh クラスタ GKE_CSM_CLUSTERがクラスタ内 istiod コントロール プレーンで実行されていることを確認します。

    次のコマンドを実行して、インストール ステータスを確認します。

    kubectl get deployment -A -l app=istiod -L istio.io/rev
    

    想定される出力は次のようになります。

    NAMESPACE              NAME                 READY   UP-TO-DATE   AVAILABLE   AGE     REV
    ISTIOD_NAMESPACE      istiod-asm-1295-12   2/2     2            2           4d16h   asm-1295-12
    
  2. 次のコマンドを使用して、istiod コントロール プレーンにエラーがないことを確認します。

    kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
    

クラスタを移行可能にする

  1. Workload Identity が クラスタとノードプールで有効になっていることを確認します。

    クラスタで Workload Identity を確認するには、次のコマンドを実行します。

    gcloud container clusters describe "GKE_CSM_CLUSTER" \
        --location="LOCATION" \
        --project="PROJECT_ID" \
        --format="value(workloadIdentityConfig.workloadPool)"
    

    GKE_CSM_CLUSTER は既存のクラスタ名に、 LOCATION はクラスタのロケーションに、 PROJECT_ID はプロジェクト ID に置き換えます。

    予想される出力:

    PROJECT_ID.svc.id.goog
    

    Workload Identity がない場合は、 Workload Identity ガイド を参照してクラスタを更新してください。

  2. クラスタがフリートに登録されていることを確認します。

    gcloud container clusters describe "GKE_CSM_CLUSTER" \
        --location="LOCATION" \
        --project="PROJECT_ID" \
        --format="yaml(fleet)"
    

    登録済みクラスタの予想される出力:

    fleet:
      membership: //gkehub.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/memberships/MEMBERSHIP_NAME
    

    フリートの詳細が空の場合は、 フリート メンバーシップの登録ガイド を参照して、クラスタをフリートに登録してください。

  3. ゲートウェイのインストールとアップグレード ガイドに沿って、Ingress ゲートウェイを使用してアプリケーションを公開します。

新しい GKE クラスタに Istio をインストールする

このセクションでは、カナリア クラスタの移行方法でオープンソースの Istio を実行する新しい GKE クラスタをプロビジョニングします。

  1. 既存のクラスタ内 Cloud Service Mesh クラスタと同じ Google Cloud プロジェクト (PROJECT_ID)に、新しい GKE クラスタ GKE_ISTIO_CLUSTERを作成します。

    クラスタを作成するときに、--project を指定し、 Workload Identity を --workload-pool=PROJECT_ID.svc.id.goog を使用して有効にしてください。

    gcloud container clusters create GKE_ISTIO_CLUSTER \
        --project=PROJECT_ID \
        --location=LOCATION \
        --workload-pool=PROJECT_ID.svc.id.goog
    

    クラスタをすでに作成している場合は、 Workload Identity ガイド を使用して Workload Identity を有効にしてください。

  2. Istio クラスタをフリートに登録します。

    gcloud container fleet memberships register \
        GKE_ISTIO_CLUSTER \
        --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \
        --enable-workload-identity \
        --location=LOCATION \
        --project=PROJECT_ID
    
  3. 公式の Istio インストール ガイド に沿って Istio をインストールします。内向きトラフィック用に Ingress ゲートウェイ がデプロイされます。スムーズな移行を行うには、同じバージョンのオープンソース Istio をインストールすることをおすすめします。オープンソースの Istio をアップグレードする場合は、Istio の リリースノートで動作の 変更を確認してください。

    クラスタ内 Cloud Service Mesh を使用する GKE クラスタと同じ方法でアプリケーションをインストールして、このクラスタを設定します。このガイドでは、Ingress ゲートウェイをホストする Namespace を ISTIO_INGRESS_NAMESPACE と呼びます。

  4. クラスタが正常で、トラフィックを処理できる状態であることを確認します。アプリケーション チームは、ライブ ユーザー トラフィックをルーティングする前に、すべてのマイクロサービスが正常に実行され、ヘルスチェックに合格していることを確認する必要があります。

専用クラスタでマルチクラスタ Gateway API を構成する

このセクションでは、GKE Gateway Controller を使用して外部アプリケーション ロードバランサ(L7XLB)を構成し、メッシュへの内向きトラフィックを有効にします。移行中は、ロードバランサを管理するために、専用の GKE 構成クラスタに Gateway API リソースをデプロイすることをおすすめします。このガイドでは、この専用構成クラスタを GKE_CONFIG_CLUSTER と呼びます。

構成クラスタを準備する

マルチクラスタ Gateway ガイドに沿って、Gateway API と HTTPRoute API をホストするように構成クラスタを準備します。

マルチクラスタ サービスを使用して Service をエクスポートする

マルチクラスタ サービス (MCS)ガイドの説明に沿って、istio-ingressgateway Service を両方のメッシュ クラスタで ServiceExport を使用してエクスポートします。

apiVersion: net.gke.io/v1
kind: ServiceExport
metadata:
  namespace: NAMESPACE
  name: SERVICE_EXPORT_NAME

構成クラスタに Gateway API リソースをプロビジョニングする

  1. Gateway Edge-to-Mesh ガイド に沿って、専用の構成 クラスタに Gateway リソースと HTTPRoute リソースを作成します。構成例は次のようになります。

    apiVersion: gateway.networking.k8s.io/v1
    kind: Gateway
    metadata:
      name: global-gateway
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      gatewayClassName: gke-l7-global-external-managed-mc
      listeners:
      - name: http
        protocol: HTTP
        port: 80
        allowedRoutes:
          namespaces:
            from: Same
    ---
    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: edge-to-mesh-route
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      parentRefs:
      - name: global-gateway
      rules:
      - backendRefs:
        # Backend 1: Cloud Service Mesh Cluster (CSM_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: CSM_INGRESS_NAMESPACE
          port: 80
          weight: 100
    
  2. ServiceImport リソースが HTTPRoute と異なる Namespace に存在する場合は、 ReferenceGrant を使用して Namespace 間トラフィック ルーティングを有効にします。

    apiVersion: gateway.networking.k8s.io/v1beta1
    kind: ReferenceGrant
    metadata:
      name: allow-csm-ingress-to-ISTIO_INGRESS_NAMESPACE
      namespace: ISTIO_INGRESS_NAMESPACE
    spec:
      from:
      - group: gateway.networking.k8s.io
        kind: HTTPRoute
        namespace: CSM_INGRESS_NAMESPACE
      to:
      - group: net.gke.io
        kind: ServiceImport
    

カナリア デプロイを使用してトラフィックを移行する

このセクションでは、トラフィックを新しいクラスタに移行して、移行を完了します。

トラフィックの 50% を Istio に移行する

このセクションでは、カナリア デプロイを実行してトラフィックを徐々に移行します。詳細については、 トラフィック分割 ガイドをご覧ください。

  1. 構成クラスタに HTTPRoute カスタム リソースを適用して、カナリア トラフィックを Istio クラスタに分割します。

    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: edge-to-mesh-route
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      parentRefs:
      - name: global-gateway
      rules:
      - backendRefs:
        # Backend 1: CSM Cluster (CSM_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: CSM_INGRESS_NAMESPACE
          port: 80
          weight: 50
        # Backend 2: Istio Cluster (ISTIO_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: ISTIO_INGRESS_NAMESPACE
          port: 80
          weight: 50
    
  2. Gateway のパブリック IP アドレスに対して並列リクエストを実行して、ライブ トラフィックの分散を検証します。

    出力例 __: レスポンスは GKE_CSM_CLUSTERと GKE_ISTIO_CLUSTERの両方で負荷分散されます。

    本番環境では、前述のように、トラフィックを段階的に移行します(1%、5%、10%、25%、50%、100% など)。これらの重みの増加がロードバランサに完全に伝播するまでに時間がかかることがあるため、さらに増やす前にトラフィックが正しく分割されていることを確認してください。

Istio クラスタへの移行を完了する

Istio クラスタ上のアプリケーションがカナリア トラフィックで正しく動作し、すべてのトラフィックが Istio クラスタに移行していることを確認します。トラフィック ルーティングが正しく機能していることを確認したら、クラスタ内 Cloud Service Mesh クラスタの ServiceExport リソースを削除して移行を完了します。

kubectl --context="GKE_CSM_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n CSM_INGRESS_NAMESPACE

GKE Gateway コントローラは、Cloud Service Mesh クラスタのネットワーク エンドポイント グループ(NEG)をロードバランサの Google Cloud バックエンド サービスから自動的に切り離します。すべての受信クライアント トラフィックは、ダウンタイムなしで Istio クラスタにシームレスに移行します。

クリーンアップ

このチュートリアルで使用したリソースに対して Google Cloud アカウントに料金が発生しないように、デプロイしたコンポーネントをクリーンアップします。

  1. Istio クラスタの ServiceExport リソースを削除します。

    kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACE
    
  2. フリート メンバーシップの登録を解除します。

    gcloud container fleet memberships unregister \
        GKE_CSM_CLUSTER \
        --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \
        --project="PROJECT_ID"
    
  3. クラスタ内 Cloud Service Mesh クラスタを削除します。

    gcloud container clusters delete GKE_CSM_CLUSTER \
        --location="LOCATION" \
        --project="PROJECT_ID"
    

次のステップ