K3s-Ansible项目中Longhorn存储部署的注意事项

背景介绍

在使用K3s-Ansible项目部署Kubernetes集群时，用户可能会遇到存储解决方案Longhorn无法正常启动的问题。这种情况通常发生在Rocky Linux 9.5等较新操作系统上部署K3s集群后尝试安装Longhorn的场景。

问题现象

当用户通过K3s-Ansible完成集群部署后，安装Longhorn时会出现以下典型症状：

1. Longhorn的Manager Pod处于CrashLoopBackOff状态
2. 查看日志会发现报错信息提示缺少iscsiadm/open-iscsi组件
3. Driver Deployer Pod卡在初始化阶段

根本原因分析

这个问题源于K3s-Ansible项目与Longhorn存储系统的职责边界划分：

1. K3s-Ansible项目专注于K3s集群本身的部署和基础配置
2. Longhorn作为分布式存储系统，有其特定的操作系统依赖要求
3. 当前K3s-Ansible的预安装角色(prereq)不包含Longhorn所需的依赖项

解决方案

要解决这个问题，用户需要在所有K3s节点上手动安装open-iscsi软件包：

1. 对于基于RPM的系统(如Rocky Linux)：

   sudo dnf install -y iscsi-initiator-utils
   

2. 对于基于Debian的系统：

   sudo apt-get install -y open-iscsi
   

安装完成后，需要重启Longhorn相关Pod或重新部署Longhorn。

最佳实践建议

1. 预先规划存储需求：在部署K3s集群前就确定是否需要使用Longhorn
2. 自动化依赖安装：可以扩展K3s-Ansible的playbook，添加open-iscsi的安装任务
3. 验证环境准备：在部署Longhorn前，手动检查各节点是否已安装所需依赖
4. 文档一致性检查：注意区分K3s官方文档和Ansible项目的职责范围

技术深度解析

open-iscsi是Longhorn的关键依赖，因为它：

1. 提供iSCSI协议支持，这是Longhorn实现块存储的基础
2. 包含iscsiadm工具，用于管理iSCSI连接
3. 实现跨节点的持久化存储卷连接

理解这一点有助于用户更好地规划Kubernetes存储架构，特别是在生产环境中。

总结

K3s-Ansible项目作为K3s集群的部署工具，其设计哲学是保持轻量和专注。存储解决方案的依赖管理属于上层应用范畴，需要用户自行处理。这种职责分离既保证了核心项目的简洁性，又给予了用户充分的灵活性。在实际部署中，理解这种边界划分能够帮助用户更高效地构建稳定的Kubernetes环境。