GitHub Actions Runner Images中Windows系统的Docker登录问题分析与解决方案

问题背景

GitHub Actions Runner Images项目中的Windows Server 2022镜像在2024年12月的更新后，用户开始报告Docker登录功能出现故障。这一问题主要影响使用大型运行器(Larger Runners)的用户，表现为在执行Docker登录操作时无法正确保存凭据。

问题表现

当用户尝试通过以下方式登录Docker时会出现错误：

1. 使用aws-actions/amazon-ecr-login登录AWS ECR
2. 使用docker/login-action登录GitHub容器注册表(ghcr.io)
3. 使用docker login命令直接登录其他私有注册表

错误信息通常显示为：

Error saving credentials: error storing credentials - err: exit status 1, out: `A specified logon session does not exist. It may already have been terminated.`

技术分析

这个问题源于Windows系统中Docker凭据存储机制的变更。在Windows系统中，Docker默认使用Windows凭据管理器来存储登录信息。当Runner镜像更新后，底层配置发生了变化，导致凭据管理器无法正常工作。

具体来说，Docker客户端尝试将凭据保存到Windows凭据存储时，系统返回了"指定的登录会话不存在"的错误。这表明当前会话环境与凭据管理器之间的交互出现了问题。

影响范围

该问题最初出现在Windows Server 2022镜像的20241211.1.0版本中，后续版本如20241215.1.0和20250105.1.0也受到影响。不仅影响大型运行器，后来也波及到标准运行器。

临时解决方案

在官方修复推出前，用户可以采用以下临时解决方案：

1. 手动创建Docker配置文件

mkdir --parents ~/.docker
echo '{"auths":{"ghcr.io":{}}}' > ~/.docker/config.json

2. 针对AWS ECR的特定配置

echo '{"auths": {"https://index.docker.io/v1/": {}}, "HttpHeaders": { "User-Agent": "Docker-Client/19.03.12 (windows)"}}' > ~/.docker/config.json

这些解决方案通过预先创建配置文件，绕过了凭据存储环节，直接配置了认证信息。

官方修复

GitHub Actions团队确认了问题根源并部署了修复。修复主要涉及恢复Runner镜像中与凭据存储相关的配置变更。根据用户反馈，修复后问题已得到解决。

最佳实践建议

1. 版本控制：在CI/CD流程中固定Runner镜像版本，避免自动更新带来的意外问题
2. 错误处理：在Docker登录步骤前后添加适当的错误处理和日志记录
3. 监控机制：建立对CI流程的监控，及时发现类似问题
4. 备份方案：为关键步骤准备替代方案，如使用不同Runner类型或版本

总结

这次事件展示了基础设施更新可能对CI/CD流程产生的连锁影响。通过社区协作和快速响应，问题得到了及时解决。对于依赖GitHub Actions的用户，建议关注Runner镜像的更新日志，并在非关键环境中测试新版本后再应用到生产环境。