This is a Helm provider for Terraform.
The provider manage the installed Charts in your Kubernetes cluster, in the same way of Helm does, through Terraform.
terraform-provider-helm is based on Terraform, this means that you need
- Terraform >=0.10.0
- Kubernetes >=1.4
The recommended way to install terraform-provider-helm is use the binary distributions from the Releases page. The packages are available for Linux and macOS.
Download and uncompress the latest release for your OS. This example uses the linux binary.
> wget https://github.com/mcuadros/terraform-provider-helm/releases/download/v0.5.0/terraform-provider-helm_v0.5.0_linux_amd64.tar.gz
> tar -xvf terraform-provider-helm*.tar.gz
Now copy the binary to the Terraform's plugins folder, if is your first plugin maybe isn't present.
> mkdir -p ~/.terraform.d/plugins/
> mv terraform-provider-helm*/terraform-provider-helm ~/.terraform.d/plugins/
If you wish to compile the provider from source code, you'll first need Go installed on your machine (version >=1.9 is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin
to your $PATH
.
Clone repository to: $GOPATH/src/github.com/mcuadros/terraform-provider-helm
> mkdir -p $GOPATH/src/github.com/mcuadros
> git clone https://github.com/mcuadros/terraform-provider-helm.git $GOPATH/src/github.com/mcuadros/terraform-providers
Enter the provider directory and build the provider
> cd $GOPATH/src/github.com/mcuadros/terraform-provider-helm
> make build
Now copy the compiled binary to the Terraform's plugins folder, if is your first plugin maybe isn't present.
> mkdir -p ~/.terraform.d/plugins/
> mv terraform-provider-helm ~/.terraform.d/plugins/
This is a small example of how to install the mariadb chart on your default kubernetes cluster, since the provider was initialized, all the configuration is retrieve from the environment. Please read the documentation for more information.
You should have a local configured copy of kubectl.
resource "helm_release" "my_database" {
name = "my_datasase"
chart = "stable/mariadb"
set {
name = "mariadbUser"
value = "foo"
}
set {
name = "mariadbPassword"
value = "qux"
}
}
Mozilla Public License 2.0, see LICENSE