Skip to content
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
helm Allow running acceptance test cases concurrently in isolation (#186) Mar 15, 2019
scripts Align module versions (#201) Feb 5, 2019
vendor Allow running acceptance test cases concurrently in isolation (#186) Mar 15, 2019
website Fix small typo in file config documentation (#243) Mar 31, 2019
.gitignore Add entries to .gitignore to roughly match the Google provider (#206) Feb 8, 2019
.travis.yml
CHANGELOG.md Cleanup after v0.9.0 release Mar 7, 2019
GNUmakefile Allow running acceptance test cases concurrently in isolation (#186) Mar 15, 2019
LICENSE
README.md Fix the travis build badge and update version Jan 6, 2019
go.mod
go.sum Enable modules in Travis & go mod tidy (#237) Mar 15, 2019
main.go

README.md

Terraform Provider for Helm Build Status GitHub release license

This is a Helm provider for Terraform.

The provider manages the installed Charts in your Kubernetes cluster, in the same way of Helm does, through Terraform. It will also install Tiller automatically if it is not already present.

Contents

Installation

Requirements

terraform-provider-helm is based on Terraform, this means that you need

Installation from binaries (recommended)

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/terraform-providers/terraform-provider-helm/releases/download/v0.7.0/terraform-provider-helm_v0.7.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/

Installation from sources

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/terraform-providers/terraform-provider-helm

> mkdir -p $GOPATH/src/github.com/terraform-providers
> git clone https://github.com/terraform-providers/terraform-provider-helm.git $GOPATH/src/github.com/terraform-providers/terraform-provider-helm

Enter the provider directory and build the provider

> cd $GOPATH/src/github.com/terraform-providers/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/

Example

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 retrieved 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-database"
    chart     = "stable/mariadb"

    set {
        name  = "mariadbUser"
        value = "foo"
    }

    set {
        name = "mariadbPassword"
        value = "qux"
    }

    set_string {
        name = "image.tags"
        value = "registry\\.io/terraform-provider-helm\\,example\\.io/terraform-provider-helm"
    }
}

License

Mozilla Public License 2.0, see LICENSE

You can’t perform that action at this time.