terraform-k8s-hcloud

KO | EN

gitlite — search

#python #hacktoberfest #llm #go #android #docker #nodejs #macos #java #awesome #cli #vue #mcp #openai

terraform-k8s-hcloud

(★ 89)

A simple project to spin your k8s cluster with terraform, kubeadm on hcloud

File Explorer

Download Latest Version (.zip)

- config.yml
- 10-kubeadm.conf
- bootstrap.sh
- copy-kubeadm-token.sh
- master.sh
- node.sh
.gitignore
install-calico.tf
LICENSE
main.tf
outputs.tf
README.md
variables.tf
versions.tf

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Terraform Kubernetes on Hetzner Cloud

This repository will help to setup an opionated Kubernetes Cluster with [kubeadm](https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/) on [Hetzner Cloud](https://www.hetzner.com/cloud?country=us).

## 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`

```toml
# 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

```console
$ 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](https://github.com/solidnerd/terraform-k8s-hcloud/issues) to report any bugs or file feature requests.

**Tested with**

- Terraform [v0.12.24](https://github.com/hashicorp/terraform/tree/v0.12.24)
- provider.hcloud [v1.19.0](https://github.com/terraform-providers/terraform-provider-hcloud)

terraform-k8s-hcloud

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

terraform-k8s-hcloud

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README