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