EKSなどで helm install を実行した際、デプロイが途中で失敗し、再度実行しようとすると以下のエラーが発生して進めなくなることがあります。

Error: cannot re-use a name that is still in use

この記事では、このエラーの原因と、EKS Cloud Shell (kubectl) を使った具体的な復旧手順（残存リソースの削除方法）について解説します。

1. エラーの原因

このエラーは、「以前のデプロイ（リリース）情報の残骸が Kubernetes クラスター内に残っている」 ために発生します。

具体的な症状

Kubernetes の管理画面や kubectl get secrets で確認すると、以下のような命名規則の Secret が残っているはずです。

命名規則: sh.helm.release.v1.<リリース名>.v<リビジョン番号>
例: sh.helm.release.v1.aws-load-balancer-controller.v1

これを手動で削除することで、エラーを解消できます。

2. 対処手順

EKS の Cloud Shell やターミナルで以下の手順を実行します。
Cloud Shellは以下をクリックするとターミナルが表示されます。

手順 1: 名前空間 (Namespace) の確認

まず、対象のリリースがどの名前空間にデプロイされようとしていたかを確認します。
AWS Load Balancer Controller などは kube-system であることが多いですが、以下のコマンドで検索して特定します。

# 全名前空間から対象のリリース名を含むSecretを検索
kubectl get secrets -A | grep <リリース名の一部>

# 例: aws-load-balancer-controller の場合
kubectl get secrets -A | grep aws-load-balancer

実行結果例:

NAMESPACE     NAME                                                   TYPE                 DATA   AGE
kube-system   sh.helm.release.v1.aws-load-balancer-controller.v1   helm.sh/release.v1   1      38m

ここで kube-system にあることが確認できました。

手順 2: 正規のアンインストールを試みる

まずは強制削除の前に、Helm コマンドでのアンインストールを試みます。

# リストを確認
helm list -n kube-system --all

# アンインストール実行
helm uninstall aws-load-balancer-controller -n kube-system

Release not found と表示される、または削除してもエラーが解消しない場合は、次の「手順 3」を実行します。

手順 3: Secret を直接削除する（解決策）

Helm コマンドで消せない場合、Kubernetes 上に残っている「Helm のリリース情報（Secret）」を直接 kubectl で削除します。

コマンド:

kubectl delete secret <Secret名> -n <名前空間>

実行例 (AWS Load Balancer Controller の場合):

kubectl delete secret sh.helm.release.v1.aws-load-balancer-controller.v1 -n kube-system

注意:
バージョン違い（v1, v2など）で複数の Secret が残っている場合は、最も新しいもの、あるいは全て削除する必要がある場合があります。

手順 4: 再インストールの実行

Secret の削除が完了したら、再度インストールコマンドを実行してください。

helm install ...

今度は「名前が使用中」というエラーが出ずにインストールが開始されるはずです。