Docker Build-Push Action 在 GitHub Enterprise Server 上的构建摘要功能限制分析

背景介绍

Docker Build-Push Action 是 GitHub Actions 生态中用于构建和推送 Docker 镜像的重要工具。在 v6.0.0 版本中，该 Action 引入了一项新功能——构建摘要(Build Summary)，旨在为开发者提供更直观的构建过程可视化。

问题现象

在 GitHub Enterprise Server (GHES) 环境中，特别是 v3.11.7 及类似版本上，用户发现构建摘要功能无法正常工作。执行过程中会出现"Failed to get backend IDs: The provided JWT token is invalid and/or missing claims"的错误提示。

技术原因分析

经过深入调查，发现问题的根源在于该功能依赖的底层库 actions/artifact v2 版本尚未支持 GHES 环境。具体表现为：

1. 构建摘要功能需要将构建记录上传为 GitHub Actions 的工件(artifact)
2. 上传过程使用了 actions/toolkit 中的 @actions/artifact v2+ 版本
3. 当前 GHES 仅支持 @actions/artifact v1.1.2 及以下版本

解决方案与变通方法

针对这一兼容性问题，Docker 团队采取了以下措施：

1. 在 v6.3.0 版本中增加了明确的错误提示，告知用户该功能在 GHES 上不可用
2. 在 v6.7.0 版本进一步优化了错误提示的显示方式，减少了对用户工作流的干扰

对于急需使用该功能的 GHES 用户，可以考虑以下变通方案：

1. 设置环境变量 DOCKER_BUILD_SUMMARY=false 来禁用构建摘要功能
2. 等待 GitHub 官方对 actions/artifact v2+ 的 GHES 支持（预计在 2024 年第四季度）

版本兼容性说明

值得注意的是，虽然 GHES 3.6 及以上版本理论上支持构建摘要功能，但由于底层依赖库的限制，Docker Build-Push Action 的构建摘要功能在 GHES 上的完全支持仍需等待 GitHub 官方的更新。

最佳实践建议

对于使用 GHES 的企业用户，建议：

1. 评估构建摘要功能对工作流的重要性
2. 如需使用，可考虑升级到最新版本的 GHES 并关注 GitHub 的更新公告
3. 在等待完全支持期间，可通过日志分析等传统方式获取构建信息

随着 GitHub 生态系统的持续发展，预计这一问题将在未来版本中得到解决，为企业用户提供更完整的 CI/CD 体验。