Harvester集群节点加入失败问题分析与解决方案

2025-06-14 16:11:04作者：吴年前Myrtle

Harvester 是一个现代、开放、互操作的超融合基础设施（HCI）解决方案，基于 Kubernetes 构建。它为寻求云原生 HCI 解决方案的运营商提供了一个开源替代方案。Harvester 运行在裸金属服务器上，提供集成的虚拟化和分布式存储功能。除了传统的虚拟机（VM），Harvester 还通过与 Rancher 的集成支持容器化环境，统一了传统虚拟化基础设施，同时促进了从核心到边缘的容器采用。

项目地址：https://gitcode.com/gh_mirrors/har/harvester

问题描述

在使用Harvester v1.4.0版本构建集群时，当管理员在UI界面添加了SSL证书后，新节点无法正常加入集群。系统日志显示新节点不断尝试但失败，主要报错信息为"Aborting system-agent installation due to requested strict CA verification with no CA checksum provided"。

问题背景

Harvester是一个基于Kubernetes的轻量级虚拟化管理平台，其核心组件rancherd负责节点的加入和管理。当配置了自定义SSL证书后，系统会启用严格的CA验证机制，但这一机制在新节点加入时出现了验证流程不完整的问题。

技术分析

证书验证机制：系统在检测到SSL证书配置后，自动启用了CATTLE_AGENT_STRICT_VERIFY严格验证模式
验证流程缺陷：新节点加入时，系统要求提供CA校验和(CA checksum)，但安装流程中未能正确传递这一参数
错误表现：系统日志显示验证失败，导致rancherd服务不断重试但无法完成节点加入过程

解决方案

临时解决方案

在新节点上创建服务覆盖配置文件：

cat > /etc/systemd/system/rancherd.service.d/override.conf <<EOF
[Service]
Environment=CATTLE_AGENT_STRICT_VERIFY=false
EOF

systemctl daemon-reload
systemctl restart rancherd.service

此方案通过禁用严格验证模式，允许节点绕过CA校验和验证加入集群。