Anthos Service Mesh をアンインストールする

このページでは、Anthos Service Mesh をアンインストールする方法について説明します。

Anthos Service Mesh をアンインストールする

以下のコマンドを使用して、Anthos Service Mesh のすべてのコンポーネントをアンインストールします。また、これらのコマンドでは、istio-system 名前空間と、すべてのカスタム リソース定義(CRD)(お客様が適用した CRD も含む)が削除されます。

  1. アプリケーション トラフィックが中断されないようにするには:

    • STRICT mTLS ポリシーを PERMISSIVE にダウングレードします。
    • トラフィックをブロックする可能性のある AuthorizationPolicy をすべて削除します。
  2. 次のコマンドで、このクラスタで自動管理を無効にします(直接適用したか、フリートのデフォルト構成を使用して適用したかに関わらず)。

      gcloud container fleet mesh update --management manual
    
  3. 名前空間でサイドカーの自動挿入機能が有効になっている場合は、これを無効にします。次のコマンドを実行して、名前空間ラベルを表示します。

     kubectl get namespace YOUR_NAMESPACE --show-labels
    

    出力は次のようになります。

     NAME   STATUS   AGE     LABELS
     demo   Active   4d17h   istio.io/rev=asm-181-5

    出力の LABELS 列の下に istio.io/rev= が表示されている場合は、削除します。

     kubectl label namespace YOUR_NAMESPACE istio.io/rev-
    

    出力の LABELS 列の下に istio-injection が表示されている場合は、削除します。

     kubectl label namespace YOUR_NAMESPACE istio-injection-
    

    istio.io/rev ラベルまたは istio-injection ラベルが表示されていない場合、名前空間で自動挿入が有効になっていません。

  4. サイドカーが挿入されたワークロードを再起動してプロキシを削除します。

  5. マネージド Anthos Service Mesh を使用している場合は、クラスタ内の controlplanerevision リソースを削除します。

    kubectl delete controlplanerevision RELEASE_CHANNEL -n istio-system
    

    RELEASE_CHANNEL は、asm-managedasm-managed-rapidasm-managed-stable など、プロビジョニングしたリリース チャンネルを示します。

  6. クラスタ内に Webhook が存在する場合は、それを削除します。

    クラスタ内の Anthos Service Mesh

    validatingwebhooksconfigurationmutatingwebhookconfiguration を削除します。

    kubectl delete validatingwebhookconfiguration,mutatingwebhookconfiguration -l operator.istio.io/component=Pilot
    

    マネージド Anthos Service Mesh

    A. validatingwebhooksconfiguration を削除します。

    kubectl delete validatingwebhookconfiguration istiod-istio-system-mcp
    

    B. mutatingwebhookconfiguration を削除します。

    kubectl delete mutatingwebhookconfiguration istiod-RELEASE_CHANNEL
    
  7. すべてのワークロードが稼働し、プロキシが確認されなくなったら、クラスタ内コントロール プレーンを安全に削除して課金を停止できます。マネージド コントロール プレーンをデプロイした場合は、前のステップで自動的に削除されます。

    クラスタ内コントロール プレーンを削除するには、次のコマンドを実行します。

    istioctl x uninstall --purge
    

    コントロール プレーンが他にない場合は、istio-system 名前空間を削除して、すべての Anthos Service Mesh リソースを削除できます。他のコントロール プレーンがある場合は、Anthos Service Mesh のリビジョンに対応するサービスを削除します。これにより、CRD などの共有リソースの削除を回避できます。

  8. 名前空間 istio-systemasm-system を削除します。

     kubectl delete namespace istio-system asm-system --ignore-not-found=true
    
  9. 削除が成功したかどうかを確認します。

     kubectl get ns
    

    次に示すように、Terminating 状態を示す出力が返されます。出力されない場合は、名前空間内の残りのリソースを手動で削除して、もう一度試してください。

     NAME                 STATUS       AGE
     istio-system         Terminating  71m
     asm-system           Terminating  71m
    
    1. クラスタを削除する場合、またはすでに削除している場合は、各クラスタがフリートから登録解除されていることを確認してください。
  10. マネージド Anthos Service Mesh のフリートのデフォルト構成を有効にしていて、将来のクラスタで無効にする場合は、無効にします。単一クラスタからのアンインストールのみを行う場合は、この手順をスキップできます。

     gcloud container hub mesh disable --fleet-default-member-config --project FLEET_PROJECT_ID
    

    ここで、FLEET_PROJECT_ID はフリート ホスト プロジェクトの ID です。

  11. マネージド Anthos Service Mesh を使用している場合は、mdp-controller Deployment を削除します。

     kubectl delete deployment mdp-controller -n kube-system
    
  12. istio-cni-plugin-config configmap が存在するかどうかを確認します。

     kubectl get configmap istio-cni-plugin-config -n kube-system
    

    istio-cni-plugin-config configmap が存在する場合は削除します。

     kubectl delete configmap istio-cni-plugin-config -n kube-system
    
  13. istio-cni-node daemonset を削除します。

     kubectl delete daemonset istio-cni-node -n kube-system
    

これらの手順を完了すると、プロキシ、クラスタ内認証局、RBAC のロールとバインディングを含むすべての Anthos Service Mesh コンポーネントが、クラスタから体系的に削除されます。インストール プロセス中に、Google 所有のサービス アカウントに、クラスタ内のサービス メッシュ リソースを確立するために必要な権限が付与されます。これらのアンインストール手順を実行しても、これらの権限は取り消されないため、今後 Anthos Service Mesh をシームレスに再有効化できます。