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

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

2025-05-21 23:59:42作者:江焘钦

微软的 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 团队已确认将处理这一问题,开发者应关注后续更新并相应调整自己的构建配置。