https://github.com/blackbird-cloud/terraform-helm-deployment
Helpers to quickly deploy helm charts on Kubernetes cluster
https://github.com/blackbird-cloud/terraform-helm-deployment
helm kubernetes terraform
Last synced: about 1 month ago
JSON representation
Helpers to quickly deploy helm charts on Kubernetes cluster
- Host: GitHub
- URL: https://github.com/blackbird-cloud/terraform-helm-deployment
- Owner: blackbird-cloud
- License: apache-2.0
- Created: 2022-09-09T13:36:04.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-31T14:07:03.000Z (over 1 year ago)
- Last Synced: 2025-01-31T14:32:35.210Z (over 1 year ago)
- Topics: helm, kubernetes, terraform
- Language: HCL
- Homepage:
- Size: 64.5 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terraform Helm Deployment Module
Helpers to quickly deploy helm charts on Kubernetes cluster
[](https://blackbird.cloud)
## Example
```hcl
provider "helm" {
kubernetes {
host = "my-k8s-host"
cluster_ca_certificate = "my-k8s-ca-cert"
token = "my-k8s-token"
}
}
module "helm_release" {
source = "blackbird-cloud/deployment/helm"
version = "1.2.1"
name = "my-app"
description = "my-app!"
namespace = "develop-app"
cleanup_on_fail = true
force_update = true
wait = true
wait_for_jobs = true
values = [
yamlencode({
image : {
repository : "my-docker-image"
tag : "v1.0.0"
}
})
]
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.1 |
| [helm](#requirement\_helm) | ~> 2 |
## Providers
| Name | Version |
|------|---------|
| [helm](#provider\_helm) | ~> 2 |
## Resources
| Name | Type |
|------|------|
| [helm_release.deployment](https://registry.terraform.io/providers/hashicorp/helm/latest/docs/resources/release) | resource |
## 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. Defaults to the local chart in this module. | `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 |
| [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)