Knative serving GKE アドオン(とそれに関連するリソースとラベル)をクラスタからアンインストールします。
このタスクでは、移行スクリプトを使用してクラスタから GKE アドオンのみを削除します。残りの Knative serving リソースはすべてクラスタに残り、トラフィックの処理を続行します。
始める前に
アップグレードの要件を満たしていることを確認する必要があります。
このページのコマンドは、アップグレード準備手順の環境変数と移行スクリプトを使用します。
このプロセスの各ステップを、指定された順序で実行することが重要です。
概要
GKE アドオンをアンインストールします。
- ノードプールがアップグレードの要件を満たしていることを確認します。
- 移行ラベルを適用してアドミッション Webhook
ValidatingWebhookConfiguration
を作成し、次の Namespace で Knative serving リソースが削除されないようにします。knative-serving
cloud-run-system
gke-system
GKE アドオンをアンインストールします。Knative serving リソースから関連するマネージャー ラベルも削除します。
このプロセスには 10 分以上かかることがあります。
appdevexperience-operator
アノテーションを追加します。フリートで使用されていない古い
cloudrun.operator.run.cloud.google.com
リソースを削除します。
Knative serving GKE アドオンをアンインストールする
このセクションでは、移行スクリプトを使用して GKE アドオンをアンインストールします。
次のコマンドを実行して、移行スクリプトを開始します。
./migration-addon.sh --command uninstall-cloudrun-addon
アクションの実行を確認するメッセージがターミナルに表示されます。「
y
」と入力してプロセスを開始します。以降も各プロンプトで入力を行います。GKE アドオンのアンインストール処理中のプロンプトは次のようになります。
In this process, the script performs the following: 1. Validating the node pool to make sure it meets the requirements for upgrading. Confirming node pool requirements for my-gcp-project/us-central1-c/my-gke-cluster... 2. Applying the required migration labels namespace/knative-serving labeled 3. Create a ValidatingWebhookConfiguration admission webhook to prevent the deletion of resources under the following namespaces: knative-serving, cloud-run-system, and gke-system Continue? [Y/n] y validatingwebhookconfiguration.admissionregistration.k8s.io/prevent-deletion-cloud-run-resources created ValidatingWebhookConfiguration prevent-deletion-cloud-run-resources for preventing deleting Knative serving resources is effective. 4. Uninstall the Knative serving GKE add-on? Your Knative serving resources remain in your cluster. Continue? [Y/n] y Updating my-gke-cluster... 5. Removing the add-on manager labels and adding the Operator related annotations. This step will take about 10 minutes. customresourcedefinition.apiextensions.k8s.io/certificates.networking.internal.knative.dev annotated 6. Clean up unused stale Knative serving operator. cloudrun.operator.run.cloud.google.com "cloud-run" deleted No resources found Knative serving GKE add-on is successfully uninstalled.
次のコマンドを実行して、GKE アドオンが
disabled
であることを確認します。gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig.disabled)'
GKE アドオンがクラスタから正常に削除されると、
True
が返されます。
次のステップ
ロールバック
上記手順での変更をロールバックする必要がある場合は、移行スクリプトで次のことを行います。
- Knative serving GKE アドオンを再度有効にする。
ValidatingWebhookConfiguration
アドミッション Webhook を削除する。
ロールバック プロセスを開始するには:
次のコマンドを実行して、移行スクリプトを開始します。
./migration-addon.sh --command rollback-uninstall-cloudrun-addon
アクションの実行を確認するメッセージがターミナルに表示されます。各プロンプトで「
y
」と入力して続行します。GKE アドオンを再度有効にする際のプロンプトは、次のようになります。
In this step, the script performs the following: 1. Enable Knative serving GKE add-on 2. Remove the ValidatingWebhookConfiguration added for uninstalling addon Continue? [Y/n] Y 1. Enable Knative serving GKE add-on? Continue? [Y/n] Y Updating my-gke-cluster...done. Knative serving GKE add-on is enabled 2. Remove the ValidatingWebhookConfiguration added for uninstalling addon? Continue? [Y/n] Y Removing the ValidatingWebhookConfiguration used to prevent deletion
Knative serving GKE アドオンが再び有効になっていることを確認します。
gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig)'
アドオンがクラスタで実行されている場合は、アドオンの構成の詳細が返されます。例:
loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL