IBM Cloud Docs
Checking your cluster version, operating system, and Kubernetes server version

Checking your cluster version, operating system, and Kubernetes server version

Review the following steps to check your IBM Cloud Kubernetes Service cluster version, worker node versions and operating system, and Kubernetes server version. For a list of supported versions and operating systems, see the Version information.

Checking your cluster master version, worker node version, and worker node operating system in the console

  1. From the Kubernetes clusters console, review your cluster master version.
  2. Select your cluster, then select Worker nodes to review your worker node version.
  3. Select Worker pools then expand your worker pools to see their operating system.

Checking your cluster master version in the CLI

Log in to your cluster to check your cluster version.

  1. Log in to your account. If applicable, target the appropriate resource group. Set the context for your cluster.
  2. List your clusters and review the output.
    ibmcloud ks cluster ls
    Example output
    cluster-us-south              cn6thtsd0ghdc110k9jg   normal        2 months ago   3         Dallas               4.14.10_1546_openshift    Default               vpc-gen2

Checking your worker node version in the CLI

Log in to your cluster to check your cluster version.

  1. Log in to your account. If applicable, target the appropriate resource group. Set the context for your cluster.
  2. Get your cluster ID.
    ibmcloud ks cluster ls
  3. List your worker nodes and review the output.
    ibmcloud ks worker ls -c CLUSTER
    Example output
    ID                                                      Primary IP     Flavor     State    Status   Zone       Version
kube-cn5gdcio0lv9l8m831ig-bharoksvpc-default-00000197   10.248.128.5   bx2.4x16   normal   Ready    jp-osa-3   4.14.10_1546_openshift*
kube-cn5gdcio0lv9l8m831ig-bharoksvpc-default-000002a3   10.248.64.5    bx2.4x16   normal   Ready    jp-osa-2   4.14.10_1546_openshift*
kube-cn5gdcio0lv9l8m831ig-bharoksvpc-default-00000371   10.248.0.5     bx2.4x16   normal   Ready    jp-osa-1   4.14.10_1546_openshift*

Checking a cluster's Kubernetes server version in the CLI

To check the Kubernetes server version of a cluster, log in to the cluster and run the following command.

kubectl version  --short | grep -i server

Example output

Server Version: v1.31+IKS

Checking your worker node operating system in the CLI

When you create a worker pool, you choose the flavor, which describes the operating system along with the compute resources of the worker nodes.

You can also log in to your cluster to check the operating system of the worker nodes.

  1. Log in to your account. If applicable, target the appropriate resource group. Set the context for your cluster.

  2. List your worker nodes.

    kubectl get nodes

  3. Describe your worker node and check for the operating system label that IBM applies, or the OS Image and Operating System fields in the System Info section.

    kubectl describe node <node>

    Example output

    NAME:               10.xxx.xx.xxx
Roles:              <none>
Labels:             arch=amd64
                    ...
                    ibm-cloud.kubernetes.io/os=UBUNTU_20_64
                    ...
                    kubernetes.io/arch=amd64
                    kubernetes.io/hostname=10.189.33.198
                    kubernetes.io/os=linux
...
System Info:
    OS Image:                   Ubuntu 20.04.5 LTS
    Operating System:           linux
    Architecture:               amd64
    ...