Terraform Kubernetes on Hetzner Cloud

This repository will help to setup an opionated Kubernetes Cluster with kubeadm on Hetzner Cloud.

Usage

$ git clone https://github.com/solidnerd/terraform-k8s-hcloud.git
$ terraform init
$ terraform apply

Example

$ terraform init
$ terraform apply
$ KUBECONFIG=secrets/admin.conf kubectl get nodes
$ KUBECONFIG=secrets/admin.conf kubectl apply -f https://docs.projectcalico.org/archive/v3.15/manifests/calico.yaml
$ KUBECONFIG=secrets/admin.conf kubectl get pods --namespace=kube-system -o wide
$ KUBECONFIG=secrets/admin.conf kubectl run nginx --image=nginx
$ KUBECONFIG=secrets/admin.conf kubectl expose deploy nginx --port=80 --type NodePort

Variables

Name	Default	Description	Required
hcloud_token	``	API Token that will be generated through your hetzner cloud project https://console.hetzner.cloud/projects	Yes
master_count	1	Amount of masters that will be created	No
master_image	ubuntu-20.04	Predefined Image that will be used to spin up the machines (Currently supported: ubuntu-20.04, ubuntu-18.04)	No
master_type	cx11	Machine type for more types have a look at https://www.hetzner.de/cloud	No
node_count	1	Amount of nodes that will be created	No
node_image	ubuntu-20.04	Predefined Image that will be used to spin up the machines (Currently supported: ubuntu-20.04, ubuntu-18.04)	No
node_type	cx11	Machine type for more types have a look at https://www.hetzner.de/cloud	No
ssh_private_key	~/.ssh/id_ed25519	Private Key to access the machines	No
ssh_public_key	~/.ssh/id_ed25519.pub	Public Key to authorized the access for the machines	No
docker_version	19.03	Docker CE version that will be installed	No
kubernetes_version	1.18.6	Kubernetes version that will be installed	No
feature_gates	``	Add your own Feature Gates for Kubeadm	No
calico_enabled	false	Installs Calico Network Provider after the master comes up	No

All variables cloud be passed through environment variables or a tfvars file.

An example for a tfvars file would be the following terraform.tfvars

# terraform.tfvars
hcloud_token = "<yourgeneratedtoken>"
master_type = "cx21"
master_count = 1
node_type = "cx31"
node_count = 2
kubernetes_version = "1.18.6"
docker_version = "19.03"

Or passing directly via Arguments

$ terraform apply \
  -var hcloud_token="<yourgeneratedtoken>" \
  -var docker_version=19.03 \
  -var kubernetes_version=1.18.6 \
  -var master_type=cx21 \
  -var master_count=1 \
  -var node_type=cx31 \
  -var node_count=2

Contributing

Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or file feature requests.

Tested with

• Terraform v0.12.24
• provider.hcloud v1.19.0