THORChain Finance
Developers
Chain Clients
THORNodes
Get Involved
Setup - Google Cloud
Setting up a Kubernetes Cluster with GCP (GKE)
Deploy a Kubernetes cluster in GCP using GKE service.
Requirements
- 1.GCP account
- 2.
gcloudand GCP credentials configured - 3.
kubectl
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!
gcloud CLI
LINUX/MAC
1
brew install google-cloud-sdk
Copied!
After the installation perform the steps outlined below. This will authorize the SDK to access GCP using your user account credentials and add the SDK to your PATH. It requires you to login and select the project you want to work in. Then add your account to the Application Default Credentials (ADC). This will allow Terraform to access these credentials to provision resources on GCP. Finally, you need to enable the Compute Engine and Kubernetes Engine API services for your GCP project.
1
gcloud init
2
gcloud auth application-default login
3
gcloud services enable compute.googleapis.com
4
gcloud services enable container.googleapis.com
Copied!
You will be asked for you Personal Access Token with read/write priveleges (retrieve from API Panel from the GCP 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
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 GKE cluster:
1
make gcp
Copied!
During the deploy, you will be asked to enter information about your cluster:
1
var.project_id
2
Project ID
3
4
Enter a value: tc-k8s-123456
5
6
var.zone
7
GCP zone in region
8
9
Enter a value: us-east1-d
Copied!
- Project ID
- Zone --
gcloud compute zones list - Confirm
yes
Deploying a cluster takes ~15 minutes
CONFIGURE
Now that you've provisioned your GKE cluster, you need to configure kubectl. The following command will get the access credentials for your cluster and automatically configure kubectl.
1
(cd gcp && gcloud container clusters get-credentials $(terraform output cluster_name) --zone $(terraform output zone))
Copied!
This replaces the existing configuration at ~/.kube/config.
Once done, you can check if your cluster is responding correctly by running the following commands.
1
kubectl version
2
kubectl get nodes
Copied!
You are now ready to deploy a THORNode.
Last modified 6mo ago
Export as PDF
Copy link
Edit on GitHub