Kubernetes での Instana エージェントのアンインストール
エージェントの展開方法に応じて、 Kubernetes 上の Instana エージェントをさまざまな方法でアンインストールできます。
準備
Instana エージェントをアンインストールする前に、アプリケーションの実行環境にインストールされているトレーサー(またはインプロセス・コレクター)をアンインストールする必要があります。
Kubernetes 環境に PHP ランタイムが含まれており、かつエージェント設定( configuration.yamlspec.agent.configuration_yaml )で PHP トレースが有効になっている(デフォルトで有効)場合は、 「 PHP トレースの無効化 」に記載されている手順に従って、 PHP Tracerをアンインストールする必要があります。
トレーサーをアンインストールした後、以下の方法を使用して、 Kubernetes のデプロイメントから Instana エージェントをアンインストールできます:
オペレーターを使用してインストールされたエージェントのアンインストール
オペレーターを使用してインストールされた Instana エージェントまたはリモートエージェントをアンインストールするには、以下の手順に従ってください:
カスタムリソースファイル ` YAML ` を削除して、エージェントをアンインストールします(例: Instana
instana-agent.customresource.yamlエージェントの場合は `,`、instana-agent-remote.yamlInstana リモートエージェントの場合は `,`):kubectl delete -f <custom-resource-file>.yaml以下のコマンドを実行して、オペレータをアンインストールします:
kubectl delete -f https://github.com/instana/instana-agent-operator/releases/latest/download/instana-agent-operator.yaml
「 Helm 」チャートを使用してインストールされたエージェントをアンインストールする
helm uninstall を実行する前に、エージェントのカスタムリソース(CR)を必ず削除してください。 そうでない場合、CRはクラスターから削除されません。「 Helm 」チャートを使用してインストールされた Instana エージェントをアンインストールするには、次のコマンドを実行してください:
NAMESPACE=instana-agent
# delete agent custom resource, the operator will remove the agent artifacts it is owning
kubectl delete agents.instana.io instana-agent -n ${NAMESPACE} --wait
# uninstall helm chart which removes the operator and RBAC artifacts
helm uninstall instana-agent -n ${NAMESPACE}
# manually uninstall the custom resource definition which is not uninstalled by helm
kubectl delete crd agents.instana.io
# remove the entire namespace
kubectl delete namespace ${NAMESPACE}
Instana ( Helm )のチャート版バージョン2以降では、instana-operatorがバックグラウンドでインストールされます。 アンインストール時、 Helm はカスタムリソース定義やカスタムリソースを自動的に削除しません。 したがって、 コマンド helm uninstall を実行するだけでは不十分です。
Instana Helm エージェントのチャートは、バージョン 2.0.0 以前のインストールでは、エージェントのカスタムリソースおよびカスタムリソース定義をインストールしません。 これらのインストールでは、リソースが見つからないという通知が表示される場合があります。 これは予期された動作です。
CRを削除する前にまずこの helm uninstall コマンドを実行する場合は、以下のコマンドを使用して、クラスタ上のエージェントのインストール全体を削除してください:
NAMESPACE=instana-agent
# remove the finalizer
kubectl patch agents.instana.io instana-agent -p '{"metadata":{"finalizers":null}}' --type=merge -n ${NAMESPACE}
# remove the cluster-wide objects
kubectl delete crd/agents.instana.io clusterrole/leader-election-role clusterrole/instana-agent-clusterrole clusterrolebinding/leader-election-rolebinding clusterrolebinding/instana-agent-clusterrolebinding
# remove helm chart,if still present
helm uninstall instana-agent -n ${NAMESPACE} || true
# delete the entire namespace
kubectl delete ns ${NAMESPACE} --wait || true
Instana をアンインストールするには、 AutoTrace WebHook, を参照してください。 Instana のアンインストールについては、 AutoTrace WebHook を参照してください。