Harvester项目中VM创建时SSH密钥生成问题的分析与解决

问题背景

在Harvester虚拟化管理平台与Rancher集成的使用场景中，用户报告了一个关于虚拟机创建过程中SSH密钥生成功能的异常问题。具体表现为：当用户通过Rancher界面创建Harvester集群中的虚拟机时，在SSH密钥选择界面点击"创建新密钥"按钮后，系统未能正常弹出创建对话框，导致无法直接在虚拟机创建流程中生成新的SSH密钥。

问题现象分析

该问题出现在特定的版本组合环境下：

• Rancher v2.10.5
• Harvester v1.4.3-rc1
• Harvester UI Extension v1.0.6-rc1

在标准的Harvester嵌入式Rancher界面中，此功能工作正常，可以顺利创建新的SSH密钥。这表明问题很可能出在Harvester UI扩展与Rancher集成的特定环节。

技术原因探究

经过开发团队分析，问题根源在于UI扩展组件的模态对话框触发机制存在缺陷。当用户在Rancher环境下通过扩展界面操作时，创建SSH密钥的对话框事件未能正确绑定和触发。这属于前端组件间的通信问题。

此外，进一步测试发现，即使用户通过其他途径创建了SSH密钥，在后续虚拟机创建过程中也存在云初始化配置不完整的问题。具体表现为生成的cloud-init配置缺少必要的"#cloud-config"声明头，这会导致SSH密钥注入失败，最终造成虚拟机无法通过SSH连接。

解决方案

开发团队通过两个主要PR解决了这个问题：

1. 修复了模态对话框无法弹出的前端问题，确保用户能够在虚拟机创建流程中正常打开SSH密钥创建界面。

2. 修正了cloud-init配置生成逻辑，确保所有通过该流程创建的SSH密钥都能正确注入到虚拟机中。具体修复内容包括：

   • 确保生成的配置包含标准的"#cloud-config"声明
   • 完善SSH公钥的注入格式
   • 验证配置在不同Linux发行版(如SLES、Ubuntu)上的兼容性

验证与确认

问题修复后，测试团队在以下环境中进行了验证：

• Rancher v2.10.5
• Harvester v1.4.3-rc2
• Harvester UI Extension v1.0.6-rc2

验证内容包括：

1. 在虚拟机创建流程中成功打开SSH密钥创建对话框
2. 创建新密钥并应用于虚拟机
3. 验证虚拟机创建后能够通过新创建的SSH密钥正常连接

所有测试用例均通过，确认问题已解决。

最佳实践建议

对于使用Harvester与Rancher集成的用户，建议：

1. 保持各组件版本同步更新
2. 创建SSH密钥时，优先使用虚拟机创建流程中的集成功能
3. 如遇连接问题，可检查虚拟机的cloud-init配置是否完整
4. 定期验证基础镜像对cloud-init的支持情况

该问题的解决不仅修复了功能缺陷，也提升了Harvester与Rancher集成的用户体验，为混合云环境下的虚拟机管理提供了更可靠的基础设施支持。