K3s-Ansible项目中Longhorn存储部署的iSCSI依赖问题解析

背景介绍

在基于K3s和Ansible构建的Kubernetes集群环境中，许多用户会选择部署Longhorn作为分布式存储解决方案。然而在实际部署过程中，经常会遇到因缺少iSCSI组件导致Longhorn组件无法正常启动的问题。

问题现象

当用户通过kubectl apply命令部署Longhorn后，通过检查Pod状态会发现：

• longhorn-manager Pod处于CrashLoopBackOff状态
• 日志显示"failed to execute iscsiadm: No such file or directory"错误
• 所有节点上的longhorn-manager均无法正常启动

根本原因分析

这个问题源于Longhorn存储系统对主机环境的依赖要求。Longhorn作为分布式块存储系统，其核心功能依赖于iSCSI协议来实现跨节点的块设备共享。具体来说：

1. Longhorn要求每个Kubernetes节点都必须安装open-iscsi软件包
2. iscsiadm是open-iscsi提供的管理工具，用于发现、登录和管理iSCSI目标
3. K3s-Ansible项目仅负责K3s集群本身的部署，不包括存储解决方案的依赖处理

解决方案

对于使用K3s-Ansible部署的集群，需要额外执行以下步骤：

1. 在所有节点上安装open-iscsi：

# 对于RockyLinux/CentOS/RHEL系
yum install -y iscsi-initiator-utils

# 对于Debian/Ubuntu系
apt-get install -y open-iscsi

2. 确保iscsi服务已启用并运行：

systemctl enable --now iscsid

3. 验证iscsiadm工具可用：

iscsiadm --version

最佳实践建议

1. 在Ansible playbook中增加open-iscsi的安装任务
2. 考虑使用节点预检脚本来验证环境依赖
3. 对于生产环境，建议将存储方案依赖纳入基础设施即代码(IaC)管理
4. 部署Longhorn前，先在所有节点上完成iscsi配置

技术延伸

理解这个问题的关键在于认识到K3s的轻量级设计理念。K3s本身不捆绑任何存储解决方案，而是提供接口支持多种存储插件。Longhorn作为独立的存储系统，有其特定的环境要求，这些要求需要在K3s集群之外单独满足。这种模块化设计虽然增加了初始配置的复杂度，但带来了更好的灵活性和可维护性。

对于希望自动化这一过程的用户，可以考虑扩展K3s-Ansible的roles，或者创建专门的storage角色来处理存储相关的依赖安装和配置。