GKE Cluster Basics¶
You will need up-to-date versions of the following tools installed -
Make sure you have initialized
gloud by running
gcloud init See
this page for details.
Create a Cluster on GKE¶
Creating a kubernetes cluster on GKE is very well documented on this page. In this guide we will be creating a "regional" cluster of 6 nodes.
By default GKE regional clusters are created in three zones within a region
unless specified otherwise. Please note that the
specifies the number of nodes per zone, not the total number of nodes.
This page lists the
available GCP regions.
Run the following command to create a 6-node GKE cluster
<REGION_NAME> with a cluster name and
region name of your choice:
A minimum of 4 nodes is required to support a Sawtooth network using the PBFT consensus plugin or a Besu network using IBFT consensus. However smaller clusters can be added to such an existing network
Make a brew as this is going to take a few minutes.
When the provisioning is complete, run the following command to generate a
kubeconfig entry for your GKE cluster, replacing
<REGION_NAME> with the name and region of your cluster.
Run the following command to check your cluster's configuration which should return something akin to the following:
This should return something similar to this
Using your Google GKE Cluster¶
Now that you have created this cluster you can add it to the list of target clusters available to Sextant by following the instructions here.
Alternatively if you intend to install Sextant on this cluster then you can do so by following the instructions here.
Delete Google GKE cluster¶
Do not delete your GKE cluster if it is running Sextant or it is hosting any Sextant-managed deployments.
Assuming that your GKE cluster isn't running Sextant, then before deleting it, make sure that it isn't hosting any Sextant-managed deployments. If it is, and you still want to delete it, then:
- Undeploy and delete any active deployments running on it using Sextant.
- Delete any provisioned clusters in Sextant.
Run the following command to delete your GKE cluster replacing
<REGION_NAME> with the appropriate cluster and region name:
This will return confirmation of the delete operation:
If the cluster listed is correct, press
Y and the delete
operation will commence.
This operation may take some time to complete.