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
$ ./install-plugin.sh
$ terraform init
$ terraform apply

Example

$ ./install-plugin.sh
$ terraform init
$ terraform apply
$ KUBECONFIG=secrets/admin.conf kubectl get nodes
$ KUBECONFIG=secrets/admin.conf kubectl apply -f https://docs.projectcalico.org/v3.2/getting-started/kubernetes/installation/hosted/etcd.yaml
$ KUBECONFIG=secrets/admin.conf kubectl apply -f https://docs.projectcalico.org/v3.2/getting-started/kubernetes/installation/rbac.yaml
$ KUBECONFIG=secrets/admin.conf kubectl apply -f https://docs.projectcalico.org/v3.2/getting-started/kubernetes/installation/hosted/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-16.04	Predefined Image that will be used to spin up the machines (Currently supported: ubuntu-16.04, debian-9,centos-7,fedora-27)	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-16.04	Predefined Image that will be used to spin up the machines (Currently supported: ubuntu-16.04, debian-9,centos-7,fedora-27)
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
ssh_public_key	~/.ssh/id_ed25519.pub	Public Key to authorized the access for the machines	No
docker_version	18.06	Docker CE version that will be installed	No
kubernetes_version	1.12.2	Kubernetes version that will be installed	No
core_dns	false	Enables CoreDNS as Service Discovery	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.9.6"
docker_version = "17.03"

Or passing directly via Arguments

$ terraform apply \
  -var hcloud_token="<yourgeneratedtoken>"
  -var docker_version=17.03
  -var kubernetes_version=1.9.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.11.5
• provider.hcloud v1.1.0