Suitenumerique/docs项目关于GitHub Actions上传构件v3版本即将停用的技术通告

GitHub官方近日发布重要通知，宣布actions/upload-artifact和actions/download-artifact的v3版本将于2024年12月5日正式停用。这一变更将直接影响所有使用这些旧版本动作的持续集成/持续部署(CI/CD)工作流。

背景说明

GitHub Actions作为GitHub提供的自动化工作流服务，其构件(Artifact)上传下载功能是CI/CD流程中的关键组件。构件功能允许用户在作业之间共享文件，如构建产物、测试报告等。v3版本作为较早期的实现，将在性能优化和功能扩展后被v4版本全面取代。

变更时间节点

GitHub将分阶段实施这一变更：

1. 2024年11月14日12:00-13:00（美国东部时间）进行首次短暂停机测试
2. 2024年11月21日9:00-17:00（美国东部时间）进行更长时间的停机测试
3. 2024年12月5日正式停用v3版本

在停机测试期间，任何尝试使用v3版本的工作流都将执行失败。正式停用后，v3版本将完全不可用。

升级必要性

v4版本带来了显著的性能提升：

• 上传速度提升最高达98%
• 下载速度也有显著改善
• 新增多项实用功能

虽然已上传的构件在保留期内仍可通过UI或API访问，但工作流必须升级才能继续正常运行。

升级注意事项

从v3迁移到v4时，开发者需要注意以下关键差异：

1. 路径处理方式变化：v4对文件路径的解析逻辑有所调整
2. 压缩算法优化：采用更高效的压缩方式
3. 错误处理机制改进：提供更详细的错误信息
4. 并发控制增强：支持更高效的并行上传

升级建议

对于Suitenumerique/docs项目及其他受影响的项目，建议采取以下步骤：

1. 立即检查项目中所有GitHub Actions工作流文件(.github/workflows/*.yml)
2. 将所有使用actions/upload-artifact@v3和actions/download-artifact@v3的引用更新为v4版本
3. 根据v4的新特性调整相关配置参数
4. 在非生产环境测试升级后的工作流
5. 监控首次停机测试期间的工作流表现

技术影响评估

这一变更主要影响：

• 使用构件功能分享构建产物的项目
• 依赖构件传递测试结果的测试流程
• 需要保存构建日志等辅助文件的工作流

对于简单的构建部署流程，升级通常只需修改版本号；对于复杂场景，可能需要调整路径配置或并行策略。

建议项目维护人员尽快安排升级工作，以避免在正式停用日期临近时出现集中升级导致的兼容性问题。