Summarizing cluster specifications

Summarizing cluster specifications by using a cluster version object

You can obtain a summary of OKD cluster specifications by querying the clusterversion resource.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You have installed the OpenShift CLI (oc).

Procedure

  1. Query cluster version, availability, uptime, and general status:

    1. $ oc get clusterversion

    Example output

    1. NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
    2. version   4.13.8    True        False         8h      Cluster version is 4.13.8

  2. Obtain a detailed summary of cluster specifications, update availability, and update history:

    1. $ oc describe clusterversion

    Example output

    1. Name:         version
    2. Namespace:
    3. Labels:       <none>
    4. Annotations:  <none>
    5. API Version:  config.openshift.io/v1
    6. Kind:         ClusterVersion
    7. # ...
    8.     Image:    quay.io/openshift-release-dev/ocp-release@sha256:a956488d295fe5a59c8663a4d9992b9b5d0950f510a7387dbbfb8d20fc5970ce
    9.     URL:      https://access.redhat.com/errata/RHSA-2023:4456
    10.     Version:  4.13.8
    11.   History:
    12.     Completion Time:    2023-08-17T13:20:21Z
    13.     Image:              quay.io/openshift-release-dev/ocp-release@sha256:a956488d295fe5a59c8663a4d9992b9b5d0950f510a7387dbbfb8d20fc5970ce
    14.     Started Time:       2023-08-17T12:59:45Z
    15.     State:              Completed
    16.     Verified:           false
    17.     Version:            4.13.8
    18. # ...