k3s-ansible项目添加工作节点失败问题分析

在使用k3s-ansible项目向现有K3s集群添加新工作节点时，用户遇到了执行playbook/upgrade.yml失败的情况。本文将深入分析这一问题，并提供正确的解决方案。

问题现象

当用户尝试通过执行playbook/upgrade.yml来添加新的工作节点时，Ansible任务在"Save current K3s service"步骤失败。具体错误表现为新节点上找不到k3s服务文件，导致cp命令执行失败。

错误日志显示新节点(192.168.1.y)上不存在/etc/systemd/system/k3s*.service文件，这实际上是一个预期行为，因为新节点尚未安装K3s服务。

问题根源

经过分析，发现问题的根本原因是用户使用了错误的playbook来添加新节点。在k3s-ansible项目中：

1. playbook/upgrade.yml主要用于升级现有集群中的节点
2. playbook/site.yml才是用于初始部署或添加新节点的正确playbook

正确操作流程

要向现有K3s集群添加新工作节点，应遵循以下步骤：

1. 编辑inventory文件，将新节点的IP地址添加到worker节点组
2. 执行主部署playbook：ansible-playbook playbook/site.yml
3. 该playbook会自动检测新节点并完成正确的安装流程

技术细节解析

在k3s-ansible项目中，不同playbook有明确分工：

• site.yml：处理初始部署和节点添加，包含完整的安装逻辑
• upgrade.yml：专注于已有节点的升级操作，假设节点已经安装过K3s

当使用upgrade.yml添加新节点时，由于新节点上尚未安装K3s，执行保存服务文件等操作自然会失败。而site.yml则包含了完整的条件判断逻辑，能够正确处理新节点的安装流程。

最佳实践建议

1. 添加节点时总是使用site.yml
2. 升级现有节点时才使用upgrade.yml
3. 在操作前仔细检查inventory文件中节点的分组是否正确
4. 对于生产环境，建议先在测试环境验证操作流程

通过遵循这些实践，可以避免类似问题的发生，确保K3s集群的稳定扩展。