https://github.com/blackbird-cloud/terraform-aws-eks-helm-release
Terraform module to assist in deploying Helm releases on your AWS EKS cluster.
https://github.com/blackbird-cloud/terraform-aws-eks-helm-release
aws eks helm terraform
Last synced: 29 days ago
JSON representation
Terraform module to assist in deploying Helm releases on your AWS EKS cluster.
- Host: GitHub
- URL: https://github.com/blackbird-cloud/terraform-aws-eks-helm-release
- Owner: blackbird-cloud
- License: apache-2.0
- Created: 2023-07-05T11:33:21.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-31T14:08:52.000Z (over 1 year ago)
- Last Synced: 2025-01-31T14:32:31.143Z (over 1 year ago)
- Topics: aws, eks, helm, terraform
- Language: HCL
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terraform Aws Eks Helm Release Module
Terraform module to assist in deploying Helm releases on your AWS EKS cluster.
[](https://blackbird.cloud)
## Example
```hcl
provider "aws" {}
module "helm_release" {
source = "blackbird-cloud/eks-helm-release/aws"
version = "~> 1"
cluster_name = "my-develop-cluster"
name = "prometheus"
repository = "https://prometheus-community.github.io/helm-charts"
chart = "kube-prometheus-stack"
chart_version = "44.4.1"
namespace = "prometheus"
create_namespace = true
values = [
yamlencode({
grafana : {
enabled : false
}
prometheus : {
prometheusSpec : {
storageSpec : {
volumeClaimTemplate : {
spec : {
storageClassName : "gp3"
accessModes : ["ReadWriteOnce"]
resources : {
requests : {
storage : "50Gi"
}
}
}
}
}
}
}
})
]
cleanup_on_fail = true
force_update = true
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.2 |
| [aws](#requirement\_aws) | ~> 5 |
| [helm](#requirement\_helm) | ~> 2 |
## Providers
| Name | Version |
|------|---------|
| [aws](#provider\_aws) | ~> 5 |
## Resources
| Name | Type |
|------|------|
| [aws_eks_cluster.cluster](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/eks_cluster) | data source |
| [aws_eks_cluster_auth.cluster](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/eks_cluster_auth) | data source |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [atomic](#input\_atomic) | If set, installation process purges chart on fail. The wait flag will be set automatically if atomic is used. Defaults to false. | `bool` | `false` | no |
| [chart](#input\_chart) | Chart name to be installed. The chart name can be local path, a URL to a chart, or the name of the chart if repository is specified. It is also possible to use the / format here if you are running Terraform on a system that the repository has been added to with helm repo add but this is not recommended. | `string` | `""` | no |
| [chart\_version](#input\_chart\_version) | Specify the exact chart version to install. If this is not specified, the latest version is installed. helm\_release will not automatically grab the latest release, version must explicitly upgraded when upgrading an installed chart. | `string` | `null` | no |
| [cleanup\_on\_fail](#input\_cleanup\_on\_fail) | Allow deletion of new resources created in this upgrade when upgrade fails. Defaults to true. | `bool` | `false` | no |
| [cluster\_name](#input\_cluster\_name) | The AWS EKS Cluster's name, in which the chart will be installed. | `string` | n/a | yes |
| [create\_namespace](#input\_create\_namespace) | Create the namespace if it does not yet exist. Defaults to false. | `bool` | `false` | no |
| [description](#input\_description) | Set release description attribute (visible in the history). | `string` | `null` | no |
| [disable\_webhooks](#input\_disable\_webhooks) | Prevent hooks from running. Defaults to false. | `bool` | `false` | no |
| [force\_update](#input\_force\_update) | Force resource update through delete/recreate if needed. Defaults to false. | `bool` | `false` | no |
| [name](#input\_name) | Release name. | `string` | n/a | yes |
| [namespace](#input\_namespace) | The namespace to install the release into. Defaults to default. | `string` | `"default"` | no |
| [recreate\_pods](#input\_recreate\_pods) | Perform pods restart during upgrade/rollback. Defaults to false. | `bool` | `false` | no |
| [repository](#input\_repository) | Repository URL where to locate the requested chart. | `string` | `null` | no |
| [repository\_password](#input\_repository\_password) | Password for HTTP basic authentication against the repository. | `string` | `null` | no |
| [repository\_username](#input\_repository\_username) | Username for HTTP basic authentication against the repository. | `string` | `null` | no |
| [sensitive\_values](#input\_sensitive\_values) | Which sensitive values to install for the helm chart. | `list(string)` | `[]` | no |
| [timeout](#input\_timeout) | Time in seconds to wait for any individual kubernetes operation (like Jobs for hooks). Defaults to 300 seconds. | `number` | `300` | no |
| [values](#input\_values) | Which values to install for the helm chart. | `list(string)` | `[]` | no |
| [wait](#input\_wait) | Will wait until all resources are in a ready state before marking the release as successful. It will wait for as long as timeout. Defaults to true. | `bool` | `true` | no |
| [wait\_for\_jobs](#input\_wait\_for\_jobs) | If wait is enabled, will wait until all Jobs have been completed before marking the release as successful. It will wait for as long as timeout. Defaults to false. | `bool` | `true` | no |
## Outputs
| Name | Description |
|------|-------------|
| [helm\_release](#output\_helm\_release) | The installed Helm release. |
## About
We are [Blackbird Cloud](https://blackbird.cloud), Amsterdam based cloud consultancy, and cloud management service provider. We help companies build secure, cost efficient, and scale-able solutions.
Checkout our other :point\_right: [terraform modules](https://registry.terraform.io/namespaces/blackbird-cloud)
## Copyright
Copyright © 2017-2024 [Blackbird Cloud](https://blackbird.cloud)