新しいクラスタでクラスタ内 Istio に移行する
このチュートリアルでは、クラスタ内 Cloud Service Mesh を使用する既存の Google Kubernetes Engine(GKE)クラスタから、オープンソースの Istio を使用する新しい GKE クラスタにアプリケーションを移行する方法について説明します。 エッジからマルチクラスタ メッシュ の機能を利用して、シームレスな移行を実現します。
用語に関する注: このチュートリアルでは、Cloud Service Mesh は Google のクラスタ内 Cloud Service Mesh を指し、Istio はオープンソースの Istio サービス メッシュを指します。
このチュートリアルの内容は次のとおりです。
- 移行のために、クラスタ内 Cloud Service Mesh を使用して既存のクラスタを準備します。
- Istio を使用して新しい GKE クラスタをプロビジョニングします。
- 専用クラスタで GKE マルチクラスタ Gateway API を構成し、マルチクラスタ サービスを構成して、メッシュ Ingress へのルーティングを設定します。
- カナリア デプロイを実行して、Cloud Service Mesh と Istio の間でライブ HTTP トラフィックを分割します。
- 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の課金対象となるコンポーネントを使用します。
このチュートリアルを完了したら、作成したリソースを削除して継続的な費用が発生しないようにできます。詳細については、 クリーンアップをご覧ください。
始める前に
-
Google Cloud コンソールのプロジェクト セレクタページで、クラスタ内 Cloud Service Mesh がインストールされている Google Cloud プロジェクト を選択します。
- アカウントに Google Cloud ログインします。 を初めて使用する場合は、 Google Cloud、 アカウントを作成して、 実際のシナリオでプロダクトがどのように機能するかを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイに利用できる $300 分の無料クレジットも提供されます。
-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.
移行のためにクラスタ内 Cloud Service Mesh を使用してクラスタを準備する
このセクションでは、クラスタ内 Cloud Service Mesh を実行している既存の GKE クラスタを、Istio を使用する GKE クラスタに移行する準備を行います。
クラスタ内 Cloud Service Mesh クラスタが実行されており、移行の準備ができていることを確認する
クラスタ内 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次のコマンドを使用して、
istiodコントロール プレーンにエラーがないことを確認します。kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
クラスタを移行可能にする
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.googWorkload Identity がない場合は、 Workload Identity ガイド を参照してクラスタを更新してください。
クラスタがフリートに登録されていることを確認します。
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フリートの詳細が空の場合は、 フリート メンバーシップの登録ガイド を参照して、クラスタをフリートに登録してください。
ゲートウェイのインストールとアップグレード ガイドに沿って、Ingress ゲートウェイを使用してアプリケーションを公開します。
新しい GKE クラスタに Istio をインストールする
このセクションでは、カナリア クラスタの移行方法でオープンソースの Istio を実行する新しい GKE クラスタをプロビジョニングします。
既存のクラスタ内 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 を有効にしてください。
Istio クラスタをフリートに登録します。
gcloud container fleet memberships register \ GKE_ISTIO_CLUSTER \ --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \ --enable-workload-identity \ --location=LOCATION \ --project=PROJECT_ID公式の Istio インストール ガイド に沿って Istio をインストールします。内向きトラフィック用に Ingress ゲートウェイ がデプロイされます。スムーズな移行を行うには、同じバージョンのオープンソース Istio をインストールすることをおすすめします。オープンソースの Istio をアップグレードする場合は、Istio の リリースノートで動作の 変更を確認してください。
クラスタ内 Cloud Service Mesh を使用する GKE クラスタと同じ方法でアプリケーションをインストールして、このクラスタを設定します。このガイドでは、Ingress ゲートウェイをホストする Namespace を
ISTIO_INGRESS_NAMESPACEと呼びます。クラスタが正常で、トラフィックを処理できる状態であることを確認します。アプリケーション チームは、ライブ ユーザー トラフィックをルーティングする前に、すべてのマイクロサービスが正常に実行され、ヘルスチェックに合格していることを確認する必要があります。
専用クラスタでマルチクラスタ 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 リソースをプロビジョニングする
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: 100ServiceImportリソースが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 に移行する
このセクションでは、カナリア デプロイを実行してトラフィックを徐々に移行します。詳細については、 トラフィック分割 ガイドをご覧ください。
構成クラスタに
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: 50Gateway のパブリック 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 アカウントに料金が発生しないように、デプロイしたコンポーネントをクリーンアップします。
Istio クラスタの
ServiceExportリソースを削除します。kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACEフリート メンバーシップの登録を解除します。
gcloud container fleet memberships unregister \ GKE_CSM_CLUSTER \ --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \ --project="PROJECT_ID"クラスタ内 Cloud Service Mesh クラスタを削除します。
gcloud container clusters delete GKE_CSM_CLUSTER \ --location="LOCATION" \ --project="PROJECT_ID"
次のステップ
- 基本アーキテクチャ ガイド(エッジからマルチクラスタ メッシュへ: GKE Gateway と Cloud Service Mesh を介してグローバルに分散されたアプリケーションをデプロイする)を読む。
- マルチクラスタ Gateway API パターンの詳細を確認する。
- マルチクラスタ ロード バランシングの詳細を確認する。
- Istio メッシュ トラフィック管理のドキュメントを確認する。