Earthly项目中Docker守护进程关闭延迟问题分析

问题背景

在Earthly构建系统中，用户发现使用WITH DOCKER指令时会出现约10秒的延迟。经过深入分析，这个问题与Docker 25.x版本引入的OpenTelemetry(OTEL)功能有关。

问题现象

当使用基于Docker 25.x版本的earthly/dind镜像时，构建过程中WITH DOCKER块执行完毕后会出现明显的延迟。通过日志分析可以观察到，这个延迟正好是10秒，且与Docker守护进程的关闭过程相关。

根本原因

Docker 25.x版本默认启用了OpenTelemetry(OTEL)功能用于遥测数据收集。当Docker守护进程关闭时，它会尝试将收集的跟踪数据导出到指定的OTLP端点。由于在Earthly的dind环境中没有配置有效的OTLP端点，导出操作会等待默认的10秒超时后才放弃。

技术细节

1. OTEL配置：Docker 25.x默认启用了OTEL跟踪功能，即使没有明确配置导出端点
2. 超时机制：OTEL导出器默认设置了10秒的超时时间
3. 日志证据：从日志中可以看到明确的错误信息"traces export: context deadline exceeded"

解决方案

有三种可能的解决方案：

1. 环境变量禁用：设置OTEL_TRACES_EXPORTER=none可以完全禁用跟踪导出
2. 缩短超时：通过OTEL_EXPORTER_OTLP_TIMEOUT环境变量减少超时时间
3. 使用旧版本：回退到Docker 20.x版本可以避免此问题

最佳实践建议

对于Earthly用户，推荐在构建中明确添加以下环境变量设置：

ENV OTEL_TRACES_EXPORTER=none

这将彻底解决延迟问题，同时保持使用最新Docker版本的优势。

性能影响

在测试案例中，禁用OTEL跟踪后：

• 构建时间从约14秒降至约5秒
• 守护进程关闭时间从10秒降至2秒左右

结论

这个问题展示了基础设施工具链中遥测功能可能带来的意外性能影响。作为构建系统用户，了解底层工具的默认行为并适当配置对于优化构建性能非常重要。Earthly用户可以通过简单的环境变量配置来避免这个特定的性能问题。