Kube-Hetzner集群部署中open-iscsi服务问题的分析与解决

在基于Kube-Hetzner项目部署Kubernetes集群时，用户可能会遇到iscsid.service服务不存在的错误。这个问题通常与Longhorn存储系统的依赖组件open-iscsi有关。本文将深入分析问题原因并提供完整的解决方案。

问题现象

当用户尝试部署Kube-Hetzner集群时，terraform执行过程中会出现如下错误信息：

Failed to enable unit: Unit iscsid.service does not exist

这表明系统无法找到并启用iscsid服务，而这个服务是Longhorn分布式存储系统的关键依赖。

根本原因分析

1. MicroOS基础镜像问题：Kube-Hetzner项目设计使用SUSE MicroOS作为节点操作系统，但标准MicroOS镜像默认不包含open-iscsi软件包。

2. 依赖关系缺失：Longhorn存储系统需要iSCSI协议支持，而open-iscsi提供了必要的用户空间工具和守护进程。

3. 自动化配置中断：Terraform脚本期望节点上已预装open-iscsi并配置好iscsid服务，当这些条件不满足时，部署流程就会中断。

解决方案

方法一：使用预构建的MicroOS快照（推荐）

Kube-Hetzner项目提供了Packer构建脚本，可以创建包含必要软件包的MicroOS镜像快照：

1. 确保已安装Packer工具
2. 克隆Kube-Hetzner仓库
3. 执行Packer构建命令创建自定义镜像
4. 在Terraform配置中引用新创建的快照ID

方法二：手动安装open-iscsi（临时方案）

对于已经创建的节点，可以临时通过以下步骤解决问题：

1. 通过SSH登录到问题节点
2. 执行以下命令安装软件包：

   transactional-update pkg install open-iscsi
   transactional-update apply
   reboot
   

3. 验证服务是否可用：

   systemctl status iscsid
   

最佳实践建议

1. 镜像准备：在集群部署前，始终使用包含必要软件包的自定义MicroOS镜像。

2. 配置验证：在Terraform执行前，检查enable_longhorn和enable_iscsid参数是否已正确设置。

3. 节点角色规划：为Longhorn存储节点配置专用标签和污点，确保存储工作负载被正确调度。

4. 服务监控：部署完成后，验证iscsid服务在所有节点上的运行状态。

技术背景

iSCSI（Internet Small Computer System Interface）是一种基于IP网络的存储协议，允许客户端（启动器）通过TCP/IP网络访问远程存储设备（目标）。在Kubernetes环境中，Longhorn等分布式存储系统依赖iSCSI来实现持久卷的动态供给和管理。

open-iscsi是Linux平台上的iSCSI启动器实现，包含：

• iscsid：iSCSI守护进程，管理会话和连接
• iscsiadm：管理iSCSI数据库和会话的命令行工具

通过理解这些底层技术原理，运维人员能更好地诊断和解决存储相关的问题。