Last modified December 7, 2022

'gsctl list releases' command reference

gsctl and the REST API are being phased out. We recommend to familiarize yourself with our Management API and the kubectl gs plugin as a future-proof replacement. We provide a migration page to help you with the transition.

The gsctl list releases command shows all workload cluster releases available in an installation.

Workload cluster releases

Workload cluster releases are software bundles that constitute the software running in a cluster. They are identified by their semantic version number in the MAJOR.MINOR.PATCH format. Check our detailed explanation of workload cluster releases to learn more.

A workload cluster release provides components, of which Kubernetes is an important one. For each workload cluster release the contained components are listed with their specific version.

An installation usually supports several workload cluster releases at the same time, which allows to select a specific workload cluster release when creating a cluster.

Usage and output

The command has no specific flags. Simply run it like this:

gsctl list releases

The resulting output is a list of all workload cluster releases, like in the following example (in this case showing one item only):

Version: 0.3.0
Created: 2017 Oct 27, 16:21 UTC
Active: true
  calico: 2.6.2
  docker: 1.12.6
  etcd: 3.2.7
  flannel: 0.9.0
  kubedns: 1.14.5
  kubernetes: 1.8.1
  nginx-ingress-controller: 0.9.0
  vault: 0.7.3
  calico: Calico version updated.
  docker: Docker version updated.
  etcd: Etcd version updated.
  flannel: Flannel version updated.
  kubedns: KubeDNS version updated.
  kubernetes: Kubernetes version updated.
  nginx-ingress-controller: Nginx-ingress-controller version updated.
  vault: Vault version updated.

The output is formatted as YAML, to allow both user-friendly and machine-readable output of hierarchical information.

Output details:

  • Version: semantic version number identifying the release
  • Created: Date/time the workload cluster release has been created
  • Active: true if the workload cluster release is usable for new cluster or upgrades. false will indicate workload cluster releases that are no longer usable for new clusters or upgrades, but which may still be running on older clusters.
  • Components: List of components provided by the release, each with their version number
  • Changelog: List of changes in components compared to the previous workload cluster release. Note that only a subset of all components may have changed.