THORChain Docs
DEVSNODES
  • Introduction
  • Using THORChain
    • Roles
      • Liquidity Providers (LPs)
      • Swappers
      • Arbitrageurs
      • Node Operators
    • RUNE
  • How It Works
    • Fees
    • Governance
    • Security
    • Incentive Pendulum
    • Emission Schedule
    • Constants and Mimir
    • THORChain Name Service
  • Ecosystem
  • Technology
    • Bifrost, TSS and Vaults
    • Midgard
    • Cosmos SDK
    • CosmWasm
    • IBC
    • THORChain & Cosmos
  • Frequently Asked Questions
    • Node Operators
    • Liquidity Providers
    • Asset Types
    • Savers
    • Lending
    • RUNEPool
  • THORChain Finance
    • Liquidity
    • Trade Assets
    • Secured Assets
    • TOR
    • RUNEPool
    • Synthetics
    • Savers
    • Lending
  • THORNodes
    • THORNode Overview
      • Node Operations
      • THORNode Stack
      • Risks, Costs and Rewards
    • Cluster Launcher
      • Setup - Linode
      • Setup - Azure
      • Setup - Hetzner Bare Metal
      • Setup - Google Cloud
      • Setup - HCloud
      • Setup - Digital Ocean
      • Setup - AWS
    • Deploying
    • Joining
    • Managing
    • Pooled THORNodes
    • Fullnode
      • Thornode - Kubernetes
      • Thornode - Linux
      • Thornode - Docker
      • Midgard - Linux
      • Midgard - Docker
      • Proxy Setup
    • Alerting
    • Leaving
    • 🛑Emergency Procedures
    • ✔️CHECKLIST
    • Multi-node Deployment
    • Developing
  • Website
  • Community Discord
  • Community Telegram
  • Developer Discord
Powered by GitBook
On this page
  • Deploy a Kubernetes cluster in GCP using GKE service.
  • Requirements
  • Steps
  • Deploy Kubernetes Cluster
  • CONFIGURE
Export as PDF
  1. THORNodes
  2. Cluster Launcher

Setup - Google Cloud

Setting up a Kubernetes Cluster with GCP (GKE)

PreviousSetup - Hetzner Bare MetalNextSetup - HCloud

Last updated 3 years ago

Deploy a Kubernetes cluster in GCP using GKE service.

Requirements

  1. GCP account

  2. gcloud and 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. Use Windows Subsystem for Linux - ****

Steps

Firstly, clone and enter the . 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 :

Install Terraform:

brew install terraform

gcloud CLI

brew install google-cloud-sdk

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.

gcloud init
gcloud auth application-default login
gcloud services enable compute.googleapis.com
gcloud services enable container.googleapis.com

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

brew install kubernetes-cli

wget && jq

brew install wget
brew install jq

Deploy Kubernetes Cluster

Use the commands below to deploy an GKE cluster:

make gcp

During the deploy, you will be asked to enter information about your cluster:

var.project_id
  Project ID

  Enter a value: tc-k8s-123456

var.zone
  GCP zone in region

  Enter a value: us-east1-d
  • 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.

(cd gcp && gcloud container clusters get-credentials $(terraform output cluster_name) --zone $(terraform output zone))

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.

The allows you to manage your GCP services.

Use the package manager to install the GCP CLI.

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.

https://docs.microsoft.com/en-us/windows/wsl/about
cluster-launcher repository
terraform CLI
gcloud CLI
homebrew
these instructions
homebrew
these instructions
homebrew