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

问题背景

在Rancher与Harvester集成环境中，用户报告了一个关于虚拟机创建流程中SSH密钥生成功能的异常情况。具体表现为：当通过Rancher界面创建Harvester集群中的虚拟机时，尝试通过"Create a new..."按钮生成新的SSH密钥时，系统未能正常弹出创建模态窗口，导致无法直接在VM创建界面生成SSH密钥。

问题现象分析

该问题出现在Rancher v2.10.5与Harvester v1.4.3-rc1的集成环境中，同时安装了Harvester UI Extension v1.0.6-rc1版本。值得注意的是，在原生Harvester（嵌入式Rancher）UI中，相同的功能可以正常工作，这表明问题可能出在Harvester UI扩展与Rancher集成的特定环节。

技术细节探究

深入分析后发现，该问题涉及前端UI组件交互逻辑的异常。当用户在VM创建表单中点击SSH密钥下拉菜单的"Create a new..."选项时，预期应该触发一个模态窗口用于输入新的SSH密钥信息。然而，在问题环境中，这个模态窗口未能正确渲染和显示。

进一步测试发现，即使用户通过其他途径（如Advanced -> SSH Keys）创建了SSH密钥，在VM创建过程中选择该密钥后，生成的cloud-init配置也存在格式问题，缺少必要的#cloud-config声明头，这会导致虚拟机实例化后SSH服务无法正常配置。

解决方案

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

1. 修复了模态窗口无法弹出的前端交互问题
2. 修正了通过模态窗口创建SSH密钥时cloud-init配置的生成逻辑

解决方案确保了：

• 模态窗口能够正常弹出并接收用户输入
• 生成的SSH密钥能够正确注入到虚拟机的cloud-init配置中
• 最终的cloud-init配置包含必要的声明头和正确格式

验证与确认

在Harvester v1.4.3-rc2、Harvester-UI-Extension v1.0.6-rc2与Rancher v2.10.5的组合环境中，修复得到了验证：

1. 可以正常通过VM创建界面的模态窗口生成新SSH密钥
2. 使用新生成的密钥创建的虚拟机能够正确配置SSH服务
3. cloud-init配置格式完整，包含必要的声明头

总结

这个案例展示了集成环境中UI组件交互可能出现的微妙问题，以及配置生成流程中格式一致性的重要性。开发团队通过前后端协同修复，确保了功能的完整性和用户体验的一致性。对于用户而言，理解这类问题的本质有助于更好地使用和管理Harvester与Rancher的集成环境。