K3s-ansible项目中Airgap模式下卸载失败的解决方案分析

问题背景

在使用k3s-ansible项目部署K3s集群时，当采用Airgap（离线）模式安装后，执行集群卸载操作会遇到失败情况。具体表现为运行reset.yml剧本时，k3s-uninstall.sh脚本会报错"Additional k3s services installed, skipping uninstall of k3s"，导致卸载过程无法完成。

问题根源分析

经过深入排查，发现问题出在airgap角色的安装任务设计上。当前实现中，无论节点是server还是agent角色，都会同时执行k3s server和agent的安装脚本。这导致每个节点上都会同时存在k3s.service和k3s-agent.service两个服务单元。

当卸载脚本k3s-uninstall.sh执行时，它会检查/etc/systemd/system/目录下是否存在多个k3s相关服务。如果发现超过一个服务文件，脚本就会认为系统安装了额外的k3s服务，出于安全考虑会中止卸载过程。

技术细节解析

在K3s的正常部署中，server节点应该只安装k3s.service，而agent节点应该只安装k3s-agent.service。然而当前airgap角色的tasks/main.yml文件中缺少必要的条件判断，导致：

1. 在server节点上，不仅安装了k3s.service，还错误地安装了k3s-agent.service
2. 在agent节点上，不仅安装了k3s-agent.service，还错误地安装了k3s.service

这种双重安装不仅造成了资源浪费，更重要的是影响了后续的卸载流程。

解决方案

解决这个问题的方案非常简单而有效：在安装任务中添加Ansible的条件判断语句when，确保：

1. server安装任务只在server组的节点上执行
2. agent安装任务只在agent组的节点上执行

修改后的任务定义如下：

- name: Run K3s Install [server]
  when: inventory_hostname in groups['server']
  ansible.builtin.command:
    cmd: /usr/local/bin/k3s-install.sh
  environment:
    INSTALL_K3S_SKIP_ENABLE: "true"
    INSTALL_K3S_SKIP_DOWNLOAD: "true"
  changed_when: true

- name: Run K3s Install [agent]
  when: inventory_hostname in groups['agent']
  ansible.builtin.command:
    cmd: /usr/local/bin/k3s-install.sh
  environment:
    INSTALL_K3S_SKIP_ENABLE: "true"
    INSTALL_K3S_SKIP_DOWNLOAD: "true"
    INSTALL_K3S_EXEC: "agent"
  changed_when: true

验证与效果

经过实际环境测试，这个修改能够确保：

1. server节点上只安装k3s.service
2. agent节点上只安装k3s-agent.service
3. 卸载脚本能够正常识别单一服务并完成卸载流程

最佳实践建议

对于使用k3s-ansible项目部署生产环境K3s集群的用户，建议：

1. 优先考虑使用airgap模式增强安全性
2. 部署前仔细检查roles/airgap/tasks/main.yml文件
3. 确保server和agent角色的安装任务有正确的条件判断
4. 测试环境先验证卸载流程是否正常

这个问题的修复不仅解决了卸载失败的问题，也使整个部署过程更加符合K3s的设计原则，确保了系统资源的合理利用和管理流程的顺畅。