Setting up a Kubernetes Cluster with Hetzner Cloud (hcloud)
This approach is only recommended for experienced operators because the kubernetes control plane among other things needs to be managed manually.
hcloud account
hcloud and hcloud credentials configured
kubectl
LINUX/MAC is the preferred method of setup.
Windows should choose either:
Deploy a THORNode from a Linux VPS.
Firstly, clone and enter the . All commands in this section are to be run inside this repo.
Then install the :
Install Terraform:
The allows you to manage your hcloud services.
Use the package manager to install the hcloud CLI.
You will be asked for you Personal Access Token with read/write priveleges (retrieve from API Panel from the hcloud web console.)
API -> Tokens/Keys -> Create Token.
Make sure you handle your secrets securely!
You must install and configure the Kubernetes CLI tool (kubectl). **To install kubectl** , follow , or choose a package manager based on your operating system.
Use the package manager to install kubectl.
You also need wget and jq, follow , or choose a package manager based on your operating system.
Use the package manager to install wget and jq Note: You most likely have these installed already.
Initialize the git submodule.
Use direnv, venv or whatever you prefer to manage a python environment inside the hcloud folder.
Install dependencies required by Python and Ansible Galaxy.
Use the commands below to deploy an hcloud cluster:
During the deploy, you will be asked to enter information about your cluster:
Name
Token
Confirm yes
If necessary, request a quota increase .
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.
You are now ready to deploy a THORNode.
ansibleUse Windows Subsystem for Linux - https://docs.microsoft.com/en-us/windows/wsl/about****
git clone https://gitlab.com/thorchain/devops/cluster-launcher
cd cluster-launcherbrew install terraformbrew install hcloud
hcloud context create <project_name>brew install kubernetes-clibrew install wget
brew install jqgit submodule update --init# Optional
(cd hcloud && direnv allow)
# Optional
(cd hcloud && virtualenv -p python3 venv)(cd hcloud && pip install -r ansible/requirements.txt)
(cd hcloud && ansible-galaxy install -r ansible/requirements.yml)make hcloudvar.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(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