THORChain Finance
Developers
Chain Clients
THORNodes
Get Involved
Setup - AWS
Setting up a Kubernetes Cluster with AWS
Deploy a Kubernetes cluster in AWS using EKS service.
Requirements
- 1.AWS account
- 2.CLI and AWS credentials configured
- 3.AWS IAM Authenticator
- 4.
kubectl - 5.
wget(required for EKS module)
LINUX/MAC is the preferred method of setup.
Windows should choose either:
- 1.Deploy a THORNode from a Linux VPS.
- 2.
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!
LINUX/MAC
Install Terraform:
1
brew install terraform
Copied!
AWS CLI
In order for Terraform to run operations on your behalf, you must install and configure the AWS CLI tool. ****To install the AWS CLI, follow these instructions, or choose a package manager based on your operating system.
LINUX/MAC
1
brew install awscli
2
aws configure
Copied!
You will be asked for you AWS access credentials (retrieve from AWS IAM from the AWS web console.)
IAM -> User -> Security Credentials -> Create Access Key.
Make sure you handle your secrets securely!
AWS IAM Authenticator
You also must install and configure the AWS IAM Authenticator tool. ****To install, follow these instructions, or choose a package manager based on your operating system.
LINUX/MAC
1
brew install aws-iam-authenticator
Copied!
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
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!
Deploy Kubernetes Cluster
Use the commands below to deploy an AWS EKS cluster. You can run the make command that automates those command for you like this:
1
make aws
Copied!
During the deploy, you will be asked to enter information about your cluster:
.png?alt=media)
- Name
- Confirm
yes
.png?alt=media)
Regions
.png?alt=media)
Note: AWS EKS is not available in some regions
Or manually:
1
cd aws/
2
terraform init
3
terraform plan # to see the plan
4
terraform apply
Copied!
Final success message:
Apply complete! Resources: 30 added, 0 changed, 0 destroyed.If you are a returning node operator and you wish to use the same node name, the Cloudwatch log files from your previous session will block this step. You need to manually delete the logs from your console:
Cloudwatch / Cloudwatch Logs / Log Groups -> "delete"
Deploying a cluster takes ~10 minutes
CONFIGURE kubectl
This is done automatically during provisioning. To configure authentication from the command line, use the following command. It will get the access credentials for your cluster and automatically configure kubectl in case you need to to manually reconfigure kubectl.
1
make kubeconfig-aws
Copied!
Or get your kubeconfig file manually:
1
(cd aws && aws eks --region $(terraform output -raw region) update-kubeconfig --name $(terraform output -raw cluster_name))
Copied!
To verify, run this, and check the status is "Ready":
1
kubectl version
2
kubectl cluster-info
3
kubectl get nodes
Copied!
You are now ready to deploy a THORNode.
BACKUPS (OPTIONAL)
Once your node is running, use the following command to automatically backup the Persistent Volumes for your Kubernetes cluster. This may help in recovering your node in the event of a disaster.
Enable backups:
1
make aws-backups
Copied!
Disable backups:
1
make aws-destroy-backups
Copied!
Last modified 6mo ago
Export as PDF
Copy link
Edit on GitHub