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 the data collected in the clusterInfo is included in the support bundle. 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.replicated.com/v1beta1
kind: Analyzer
  name: check-kubernetes-version
  - clusterVersion:
        - fail:
            when: "< 1.16.0"
            message: The application requires at 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