この手順は、Istio on GKE(Istio アドオン)のインストールに固有のものです。
始める前に
アップグレードの要件を満たしていることを確認する必要があります。
このページのコマンドは、アップグレード準備手順の環境変数と移行スクリプトを使用します。
このプロセスの各ステップを、指定された順序で実行することが重要です。
Istio アドオンが使用されているかどうかを確認する
クラスタ内で Istio アドオンの Ingress ゲートウェイまたはサイドカー インジェクション機能が使用されているかどうかによって、2 通りの移行パスがあります。
準備ステップで、Istio アドオンが構成されているかどうかを確認しました。次のコマンドを実行して、
istio-system
Namespace が存在することを確認します。echo $INGRESS_NAMESPACE
次のコマンドを実行して、Istio アドオンのサイドカー インジェクション機能がクラスタ内で使用されているかどうかを確認します。
kubectl get ns -l istio-injection=enabled
knative-serving
以外の Namespace が表示されている場合は、Istio アドオンのサイドカー インジェクションが使用されています。たとえば、
knative-serving
Namespace のみが表示されている場合は、Istio アドオンのサイドカー インジェクションは構成されず、使用されていません。
結果:
いずれか、または両方を使用 - Istio アドオン機能の一方または両方がクラスタ内で使用されています。
- Istio アドオンの Ingress サービス
istio-ingressgateway
が使用されます。 - Istio アドオンのサイドカー インジェクションが使用されています。
次のステップ: 次のセクションの指示に従って Istio アドオンをアンインストールし、Cloud Service Mesh とマネージド コントロール プレーン ガイドに進みます。
- Istio アドオンの Ingress サービス
未使用 - クラスタ内で使用するように、Ingress ゲートウェイも Istio アドオンのサイドカー インジェクションも構成されていません。つまり、インストールで Istio のバンドル バージョンが使用されています。
次のステップ: 次のセクションの手順を実施して、未使用の Istio アドオンをアンインストールし、Cloud Service Mesh とクラスタ内コントロール プレーン ガイドに進みます。
Istio アドオンをアンインストールする
このセクションでは、移行スクリプトを使用して Istio アドオンをアンインストールします。
次のコマンドを実行して、移行スクリプトを開始します。
./migration-addon.sh --command uninstall-istio-addon
istio-system
Namespace が削除されたことを確認します。kubectl get ns istio-system --ignore-not-found
次のステップ
上記で特定した Ingress ゲートウェイの構成に応じて、対応するインストール ガイドに進みます。
クラスタ内で Istio アドオン機能のいずれか、または両方が構成され、クラスタが使用されていることを事前に確認した場合は、Cloud Service Mesh とマネージド コントロール プレーン ガイドに進みます。
Istio アドオンの Ingress ゲートウェイとサイドカー インジェクションがクラスタで使用されていないことを事前に確認した場合、インストールでは Istio のバンドル バージョンが使用されています。これで、クラスタ内コントロール プレーンと Cloud Service Mesh のインストールに進むことができます。
ロールバック
上記の手順で加えた変更をロールバックする必要がある場合は、移行スクリプトを使用して Istio アドオンを再度有効にします。
次のコマンドを実行します。
./migration-addon.sh --command rollback-uninstall-istio-addon
インストールに対する変更を元の状態にロールバックするには、Knative serving GKE アドオンをロールバックします。