Rancher v2.5 provisioned Kubernetes clusters, without a worker role node, display "Cluster health check failed: cluster agent is not ready" error
This document (000020043) is provided subject to the disclaimer at the end of this document.
When provisioning or updating a Rancher-provisioned Kubernetes cluster in Rancher v2.5.x, such that the cluster does not have a node with the worker role, the cluster will enter an
Error status, displaying the message
Cluster health check failed: cluster agent is not ready. By comparison, in Rancher v2.4.x, the cluster status would show
Active in this scenario.
- A Rancher v2.5.x instance
server-urlconfigured to a resolvable hostname, e.g. rancher.example.com, and not an IP address
- A Rancher provisioned Kubernetes cluster, either a Custom cluster or with nodes in an infrastructure provider using a Node Driver
Rancher v2.5.x implements an additional cluster health check to ensure that the Pod for the
cluster-agent Deployment in the
cattle-system namespace of the downstream cluster is ready and successfully connected to the Rancher server. The
cluster-agent Pod will use cluster DNS to resolve the Rancher server hostname. As a result, in the instance that there is no node with the worker role, CoreDNS Pods will be unable to schedule and the
cluster-agent will thus be unable to resolve the Rancher hostname, causing this check to fail.
Provision a node in the cluster with the worker role, to ensure that CoreDNS Pods can be successfully scheduled.
This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.
- Document ID:000020043
- Creation Date: 06-May-2021
- Modified Date:06-May-2021
- SUSE Rancher
For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com