Setup - HCloud
Setting up a Kubernetes Cluster with Hetzner Cloud (hcloud)
Deploy an unmanaged Kubernetes cluster in hcloud
This approach is only recommended for experienced operators because the kubernetes control plane among other things needs to be managed manually.
Requirements
- hcloud account
hcloud
and hcloud credentials configuredkubectl
ansible
Preferred Setup: LINUX/MAC
Windows users: Choose either:
- Deploy from a Linux VPS.
- Use Windows Subsystem for Linux - Learn more
Steps
Clone Repository
First, clone and enter the cluster-launcher repository. Run all commands within this repo.
git clone https://github.com/LastL2/cluster-launcher
cd cluster-launcher
Install Terraform
Install the Terraform CLI:
Install Terraform:
brew install terraform
hcloud CLI
The hcloud CLI allows you to manage your hcloud services.
Use the package manager homebrew to install the hcloud CLI.
brew install hcloud
hcloud context create (project_name))
You will be asked for your Personal Access Token with read/write privileges (retrieve from API Panel from the hcloud web console).
API -> Tokens/Keys -> Create Token.
Make sure you handle your secrets securely!
Kubernetes Control Tool
You must install and configure the Kubernetes CLI tool (kubectl). To install kubectl, follow these instructions, or choose a package manager based on your operating system.
Use the package manager homebrew to install kubectl.
brew install kubernetes-cli
wget && jq
You also need wget and jq, follow these instructions, or choose a package manager based on your operating system.
Use the package manager homebrew to install wget and jq Note: You most likely have these installed already.
brew install wget
brew install jq
Environment
Initialize the git submodule.
git submodule update --init
Use direnv
, venv
or whatever you prefer to manage a python environment inside the hcloud folder.
# Optional
(cd hcloud && direnv allow)
# Optional
(cd hcloud && virtualenv -p python3 venv)
Install dependencies required by Python and Ansible Galaxy.
(cd hcloud && pip install -r ansible/requirements.txt)
(cd hcloud && ansible-galaxy install -r ansible/requirements.yml)
Deploy Kubernetes Cluster
Use the commands below to deploy an hcloud cluster:
make hcloud
During the deploy, you will be asked to enter information about your cluster:
var.name
The base name used for all resources
Enter a value: tc-k8s
var.token
Hetzner Cloud API token
Enter a value: <secret>
var.user_name
The admin user name for the nodes
Enter a value: admin
- Name
- Token
- Confirm
yes
Deploying a cluster takes ~15 minutes
Quotas
If necessary, request a quota increase here.
CONFIGURE
Now that you’ve provisioned your hcloud cluster, you need to configure kubectl. Customize the following command with your cluster name and resource group. It will get the access credentials for your cluster and automatically configure kubectl.
(cd hcloud && scp $(terraform output -raw hcloud_config) ~/.kube/config-hcloud)
# Merge it and set current context
KUBECONFIG=~/.kube/config:~/.kube/config-hcloud kubectl config view --flatten > ~/.kube/tmpcfg && mv -f ~/.kube/tmpcfg ~/.kube/config && kubectl config use-context $(kubectl config current-context --kubeconfig=$HOME/.kube/config-hcloud)
kubectl version
You are now ready to deploy a LastNode.