Troubleshooting: Common Errors

Common Errors and Solutions

This page documents common errors you might encounter during deployment and how to resolve them.

1. Helm Installation Failed - Name Already In Use

Error Message:

Error: installation failed

  with helm_release.user_openvscode["arena-american12"],
  on openvscode.tf line 47, in resource "helm_release" "user_openvscode":
  47: resource "helm_release" "user_openvscode" {

cannot re-use a name that is still in use

Cause:
This error occurs when Terraform/Terragrunt tries to install a Helm chart, but a release with the same name already exists in the Kubernetes cluster. This can happen if:

A previous deployment failed midway
Resources were not properly cleaned up
The Terraform state is out of sync with the actual cluster state

Solution:

List all Helm releases to identify the problematic release:
```
helm list --all-namespaces
```
Look for the release name mentioned in the error (e.g., arena-american12).
Uninstall the existing release:
```
helm uninstall <release-name> -n <namespace>
```
For example:
```
helm uninstall arena-american12 -n default
```
💡 Note: Replace <release-name> with the actual release name and <namespace> with the appropriate namespace (often default unless specified otherwise).
Verify the release is removed:
```
helm list --all-namespaces
```
Re-run the Terraform/Terragrunt apply:
```
terragrunt apply --all
```

Alternative Solution:
If you need to import the existing Helm release into Terraform state instead of uninstalling it:

terragrunt import --working-dir=eks-cluster 'helm_release.user_openvscode["arena-american12"]' default/arena-american12

Getting Help

If you encounter an error not listed here, please:

Check the Terraform/Terragrunt logs for detailed error messages
Verify your AWS credentials and permissions
Ensure all prerequisites are met (see the Setup page)
Contact the team for assistance