Links

Setup - Azure

Setting up a Kubernetes Cluster with Azure (AKS)

Deploy a Kubernetes cluster in Azure using AKS service.

Requirements

  1. 1.
    Azure account
  2. 2.
    az and Azure credentials configured
  3. 3.
    kubectl
LINUX/MAC is the preferred method of setup.
Windows should choose either:
  1. 1.
    Deploy a THORNode from a Linux VPS.
  2. 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.
git clone https://gitlab.com/thorchain/devops/cluster-launcher
cd cluster-launcher
Then install the terraform CLI:
LINUX/MAC
Install Terraform:
brew install terraform

Azure CLI

The Azure CLI allows you to manage your Azure services.
LINUX/MAC
Use the package manager homebrew to install the Azure CLI.
brew install azure-cli
az login
You will be asked for you Personal Access Token with read/write priveleges (retrieve from API Panel from the Azure 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.
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.
LINUX/MAC
Use the package manager homebrew to install wget and jq Note: You most likely have these installed already.
brew install wget
brew install jq

Deploy Kubernetes Cluster

Use the commands below to deploy an AKS cluster:
make azure
During the deploy, you will be asked to enter information about your cluster:
var.location
The location where the Managed Kubernetes Cluster should be created
Enter a value: eastus2
var.name
The base name used for all resources
Enter a value: tc-k8s
  • Location -- az account list-locations -o table
  • Name
  • Confirm yes
Deploying a cluster takes ~15 minutes

CONFIGURE

Now that you've provisioned your AKS 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.
az aks get-credentials -a -g <resource_group> -n <cluster_name>
This replaces the existing configuration at ~/.kube/config.
Once done, you can check if your cluster is responding correctly by running the following commands.
kubectl version
kubectl get nodes
You are now ready to deploy a THORNode.