Cluster Version

How to write analyzers to check the Kubernetes version

The clusterVersion analyzer is used to report on the installed version of Kubernetes. This checks the cluster version, not the version of kubectl. The when attribute specifies a semver range to compare the running version against and supports all standard comparison operators.

The clusterVersion analyzer uses data from the clusterInfo collector. The clusterInfo collector is automatically added and will always be present.

To implement an analyzer that has a minimum version, specify that version as a fail or warn outcome first, and have a default outcome for pass. This will allow the pass outcome to always succeed when the fail or warn outcomes are not truthy.

An example clusterVersion analyzer that reports a failure on Kubernetes less than 1.16.0, a warning when running 1.16.x, and a pass on 1.17.0 or later is included here.


There are no parameters available for this analyzer.

Example Analyzer Definition

apiVersion: troubleshoot.sh/v1beta2
kind: Preflight
  name: check-kubernetes-version
    - clusterVersion:
          - fail:
              when: "< 1.16.0"
              message: The application requires Kubernetes 1.16.0 or later
              uri: https://kubernetes.io
          - warn:
              when: "< 1.17.0"
              message: Your cluster meets the minimum version of Kubernetes, but we recommend you update to 1.17.0 or later.
              uri: https://kubernetes.io
          - pass:
              message: Your cluster meets the recommended and required versions of Kubernetes.
Edit on GitHub