Last modified January 31, 2019

gsctl show cluster

The gsctl show cluster command displays details on a cluster.

Usage

gsctl show cluster <cluster-id>

Output details

Example output for an AWS based cluster:

ID:                            vxvc7
Name:                          Staging cluster for Frontend
Created:                       2019 Jan 30, 09:26 UTC
Organization:                  acme
Kubernetes API endpoint:       https://api.vxvc7.REDACTED.aws.gigantic.io
Release version:               6.3.0
Worker node scaling:           autoscaling between 6 and 10
Desired worker node count:     7
Worker nodes running:          8
Worker EC2 instance type:      m5.large
CPU cores in workers:          14
RAM in worker nodes (GB):      26.5

Example output for a KVM based cluster:

ID:                            tjjm7
Name:                          Staging Cluster
Created:                       2018 Mar 06, 14:23 UTC
Organization:                  acme
Kubernetes API endpoint:       https://api.tjjm7.REDACTED.kvm.gigantic.io
Release version:               2.2.1
Workers:                       2
CPU cores in workers:          4
RAM in worker nodes (GB):      4
Storage in worker nodes (GB):  80
Ingress port for http:         30020
Ingress port for https:        30021

The output lines in detail:

  • ID: unique cluster identifier
  • Name: cluster name
  • Created: date and time of cluster creation
  • Organization: organization owning the cluster
  • Kubernetes API endpoint: URL of the Kubernetes API for this cluster
  • Release version: Version number of the release used in this cluster
  • Worker node scaling: Scaling limits. Shows either autoscaling between <min> and <max> for an autoscaling cluster, or pinned to <num> where autoscaling is disabled or where it’s not available.
  • Desired worker node count: Only shown for autoscaling clusters. The number of worker nodes the autoscaler intends to have running.
  • Worker nodes running: The current number of worker nodes running in this cluster.
  • Worker EC2 instance type: (only on AWS) EC2 instance type used for worker nodes
  • Worker VM size: (only on Azure) VM size used for worker nodes
  • CPU cores in workers: total number of CPU cores in all worker nodes in this cluster
  • RAM in worker nodes (GB): total amount of memory in all worker nodes in this cluster
  • Storage in worker nodes (GB): (only for KVM) total amount of local storage in all worker nodes in this cluster
  • Ingress port for <protocol>: (only for KVM) the port to forward traffic to from your data center’s load balancer(s) to this cluster’s ingress controller for that specific protocol
  • AWS account: (only on AWS) If the cluster is running using non-default provider credentials, here we show the AWS account ID
  • Azure subscription: (only on Azure) If the cluster is running using non-default provider credentials, here we show the subscription ID
  • Azure tenant: (only on Azure) If the cluster is running using non-default provider credentials, here we show the tenant ID

Note that some dynamic pieces of information, like the current number of workers, and the desired worker count, may take up to five minutes to be updated.