THORChain
Search…
Setup - HCloud
Setting up a Kubernetes Cluster with Hetzner Cloud (hcloud)

Deploy an umnanaged 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

    1.
    hcloud account
    2.
    hcloud and hcloud credentials configured
    3.
    kubectl
    4.
    ansible
LINUX/MAC is the preferred method of setup.
Windows should choose either:
    1.
    Deploy a THORNode from a Linux VPS.
    2.
    Use Windows Subsystem for Linux - https://docs.microsoft.com/en-us/windows/wsl/about****

Steps

Firstly, clone and enter the cluster-launcher repository. All commands in this section are to be run inside this repo.
1
git clone https://gitlab.com/thorchain/devops/cluster-launcher
2
cd cluster-launcher
Copied!
Then install the terraform CLI:
LINUX/MAC
Install Terraform:
1
brew install terraform
Copied!

hcloud CLI

The hcloud CLI allows you to manage your hcloud services.
LINUX/MAC
Use the package manager homebrew to install the hcloud CLI.
1
brew install hcloud
2
hcloud context create <project_name>
Copied!
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!

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.
LINUX/MAC
Use the package manager homebrew to install kubectl.
1
brew install kubernetes-cli
Copied!

wget && jq

You also need wget and jq, follow these instructions, or choose a package manager based on your operating system.
LINUX/MAC
Use the package manager homebrew to install wget and jq Note: You most likely have these installed already.
1
brew install wget
2
brew install jq
Copied!

Environment

Initialize the git submodule.
1
git submodule update --init
Copied!
Use direnv, venv or whatever you prefer to manage a python environment inside the hcloud folder.
1
# Optional
2
(cd hcloud && direnv allow)
3
​
4
# Optional
5
(cd hcloud && virtualenv -p python3 venv)
Copied!
Install dependencies required by Python and Ansible Galaxy.
1
(cd hcloud && pip install -r ansible/requirements.txt)
2
(cd hcloud && ansible-galaxy install -r ansible/requirements.yml)
Copied!

Deploy Kubernetes Cluster

Use the commands below to deploy an hcloud cluster:
1
make hcloud
Copied!
During the deploy, you will be asked to enter information about your cluster:
1
var.name
2
The base name used for all resources
3
​
4
Enter a value: tc-k8s
5
​
6
var.token
7
Hetzner Cloud API token
8
​
9
Enter a value: <secret>
10
​
11
var.user_name
12
The admin user name for the nodes
13
​
14
Enter a value: admin
Copied!
    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.
1
(cd hcloud && scp $(terraform output -raw hcloud_config) ~/.kube/config-hcloud)
2
​
3
# Merge it and set current context
4
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)
5
​
6
kubectl version
Copied!
You are now ready to deploy a THORNode.
Last modified 5d ago