Actions Runner Images 项目中 AzureRM 模块引发的问题分析

微软的 Actions Runner Images 项目最近在 Windows Server 2022 的 20250120.2 版本镜像中，将 AzureRM PowerShell 模块从 2.1.0 版本升级到了 5.3.0 版本，这一变更引发了严重的技术兼容性问题。

问题背景

AzureRM 模块是微软早期为 Azure 资源管理提供的 PowerShell 模块，但该模块已被官方正式弃用多年，其替代品是新一代的 Az 模块。Az 模块不仅提供了更完整的功能覆盖，还具有更好的性能和更现代的架构设计。

问题表现

在最新版本的 Windows 镜像中，由于预装了较新版本的 AzureRM 模块，导致用户在尝试安装 Az 模块时遇到严重冲突。具体表现为：

1. 在 PowerShell 5.1 环境中，安装 Az 模块时出现版本冲突错误
2. 在 PowerShell 7 环境中同样无法完成 Az 模块的安装
3. 系统默认加载的是已被弃用的 AzureRM 模块而非推荐的 Az 模块

技术影响

这一问题对用户的影响主要体现在以下几个方面：

1. 开发环境不一致：本地开发环境通常使用 Az 模块，而 CI/CD 环境中却强制使用 AzureRM，导致脚本行为不一致
2. 功能缺失：AzureRM 模块缺少许多新 Azure 服务的支持，限制了自动化脚本的能力
3. 维护困难：用户被迫同时维护两套不同模块的脚本，增加了维护成本
4. 安全隐患：弃用的模块不再接收安全更新，可能引入潜在风险

解决方案建议

针对这一问题，建议采取以下措施：

1. 立即回滚：将 Windows 镜像中的 AzureRM 模块恢复至原版本或完全移除
2. 模块清理：彻底从预装软件包中移除 AzureRM 模块
3. 标准统一：将 Az 模块作为默认的 Azure PowerShell 客户端
4. 版本控制：确保预装模块不会与用户自行安装的模块产生冲突

最佳实践

对于受影响的用户，可以采取以下临时解决方案：

1. 在 CI/CD 脚本开始时显式移除 AzureRM 模块
2. 使用模块隔离技术，如 PowerShell 模块沙箱
3. 在管道中明确指定所需的 Az 模块版本
4. 考虑使用容器化的构建环境以避免主机环境影响

总结

这一事件提醒我们基础设施维护中版本管理的重要性。作为云原生时代的开发者，我们应当：

1. 密切关注官方文档中关于模块生命周期的说明
2. 在 CI/CD 管道中实施严格的依赖管理
3. 定期更新和验证构建环境配置
4. 建立环境变更的监控和回滚机制

微软 Actions Runner Images 团队已确认将处理这一问题，开发者应关注后续更新并相应调整自己的构建配置。