Pants构建系统应对GitHub Actions中macOS 12运行器停用的技术方案

GitHub官方近期宣布将于2024年12月3日停止支持macOS 12运行器镜像，这一变更将对Pants构建系统的持续集成流程产生直接影响。作为项目维护团队，我们需要审慎评估影响范围并制定迁移策略，确保构建管道的稳定性。

背景分析

GitHub Actions作为Pants项目CI/CD的核心基础设施，其运行器环境变更将影响多个版本分支的构建能力。当前Pants各版本分支的macOS支持矩阵如下：

• 2.22.x分支：使用自托管运行器（x86-64架构macOS 10.15，arm64架构macOS 11）
• 2.23.x分支：同样采用自托管运行器（环境与2.22.x相同）
• 2.24.x分支：依赖GitHub托管的macOS 12运行器（x86-64）
• 开发中版本：计划迁移至GitHub托管的macOS 13/14运行器

技术挑战

核心问题集中在2.24.x版本分支，该分支当前依赖即将停用的macOS 12运行器。考虑到2.24.0正式版尚未发布，且后续可能需要发布补丁版本（如2.24.1等），我们需要解决以下技术难点：

1. 版本分支的生命周期管理
2. 构建环境向后兼容性
3. 多架构（x86-64/arm64）的构建一致性

解决方案评估

经过技术评估，团队提出三个可行性方案：

方案一：限制性发布策略

仅发布2.24.0版本后立即转向2.25.x开发。这种方案虽然简单，但会限制补丁版本的发布灵活性，可能影响紧急修复的交付。

方案二：提前弃用策略

将macOS 12弃用计划提前应用到2.23.x分支。虽然技术上可行，但会导致版本间的策略不一致，增加用户的理解成本。

方案三：回退自托管方案（推荐）

将2.24.x分支切换回自托管运行器（macOS 10.15），同时保持对新版macOS的运行时警告机制。该方案具有以下优势：

• 保持构建环境稳定性
• 不中断现有发布流程
• 提供平滑过渡期
• 保持多版本策略一致性

实施建议

基于技术评估，推荐采用方案三并配合以下实施步骤：

1. CI配置迁移：修改2.24.x分支的GitHub Actions工作流，回退到自托管运行器
2. 版本兼容性声明：在文档中明确各版本对macOS环境的支持范围
3. 运行时检测：增强版本检测逻辑，当检测到即将不受支持的macOS版本时输出显式警告
4. 监控机制：建立构建成功率监控，及时发现环境适配问题

长期规划

本次事件也提示我们需要建立更灵活的CI环境管理策略：

1. 制定运行器环境生命周期管理规范
2. 建立主要版本与运行器版本的映射关系
3. 完善多架构构建的测试矩阵
4. 考虑容器化构建环境提升可移植性

通过系统性的技术规划和实施方案，Pants项目将平稳度过此次基础设施变更，同时为未来的环境演进建立更健壮的应对机制。