Skip to content

Latest commit

 

History

History
58 lines (41 loc) · 2.01 KB

README.md

File metadata and controls

58 lines (41 loc) · 2.01 KB

Terraform Provider for Gardener

Overview

The Terraform Provider for Gardener enables Terraform to provision Kubernetes clusters on chosen cloud providers using Gardener. Currently, the Terraform Provider for Gardener supports AWS, Azure, and GCP.

Prerequisites

  • Terraform 0.12+
  • Go 1.12 or higher
  • Gardener project with kubeconfig access and configured cloud provider secrets

Development

Perform the following steps to build the providers:

  1. Build the provider:

    go build -o terraform-provider-gardener

  2. Move the gardener provider binary into the terraform plugins folder:

    On MacOS:

    mv terraform-provider-gardener ~/.terraform.d/plugins/terraform-provider-gardener

    For other systems and further details, see this document.

Usage

At the moment, the Terraform Provider for Gardener defines a resource type gardener_shoot which is linked to the corresponding shoot Gardener resource. The table shows the cloud provider-specific configuration and related examples:

Cloud Provider Specification Example
Amazon Web Services schema.go main.tf
Google Cloud Platform schema.go main.tf
Azure schema.go main.tf

Perform the following steps to use the provider:

  1. Go to one of the main.tf files listed above.

  2. Edit the main.tf file to provide the missing parameters.

  3. Initialize Terraform:

    terraform init

  4. Plan the provisioning:

    terraform plan

  5. Deploy the cluster:

    terraform apply