terraform-provider-gardener

README

Terraform Provider for Gardener

Overview

The Terraform Provider for Gardener enables Terraform to provision Kubernetes clusters on chosen cloud providers using Gardener. Currently, it 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
Goocle 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