KEDA项目中IBM MQ Scaler的优化与参数清理

背景介绍

在Kubernetes事件驱动自动扩展（KEDA）项目中，IBM MQ Scaler是一个用于根据IBM MQ队列深度自动扩展工作负载的重要组件。近期，社区成员发现该Scaler中存在一些需要优化的参数设计和文档不一致问题。

参数清理与优化

移除未使用的queueManager参数

当前实现中，queueManager参数虽然被要求配置且进行了非空检查，但实际上在代码逻辑中并未被使用。这种设计会导致用户必须配置一个实际上无用的参数，增加了不必要的配置复杂度。优化方案是直接移除对该参数的处理逻辑，简化用户配置。

TLS相关参数标准化

目前IBM MQ Scaler中存在两个与TLS安全相关的参数：

1. tlsDisabled：文档中描述的功能与代码实现不符，实际上从未生效
2. unsafeSsl：与其他Scaler组件保持一致的参数命名

为了保持KEDA项目各组件间的一致性，决定采用以下演进策略：

1. 在2.18版本中将tls参数标记为"已弃用"，建议用户改用unsafeSsl
2. 后续版本中完全移除对tls参数的支持
3. 统一使用unsafeSsl参数来控制是否跳过TLS证书验证

这种调整不仅解决了当前参数功能不一致的问题，还使IBM MQ Scaler与其他Scaler组件保持一致的配置风格，降低了用户的学习成本。

文档修正

在检查过程中还发现文档中queueDepth参数的默认值描述与实际代码实现不一致：

• 文档声明默认值为5
• 代码实现实际使用20作为默认值

这种文档与代码的不一致会导致用户误解和配置错误。优化方案是将文档更新为反映真实的默认值20，确保文档与代码实现完全一致。

技术影响分析

这些优化将带来以下技术收益：

1. 配置简化：移除无用参数后，用户配置更加简洁明了
2. 一致性提升：TLS相关参数与其他Scaler组件保持一致，降低认知负担
3. 可靠性增强：文档与实际行为一致，减少配置错误
4. 维护性提高：清理无用代码后，代码库更加清晰，便于后续维护

实施建议

对于现有用户，建议采取以下迁移策略：

1. 检查并移除配置中无用的queueManager参数
2. 将tls参数逐步替换为unsafeSsl
3. 根据实际需求评估queueDepth参数值，注意默认值已更新为20

这些优化体现了KEDA项目对代码质量和用户体验的持续追求，通过定期清理和技术债务偿还，确保项目保持健康可持续发展。