Earthly项目在Docker Rootless模式下启动失败的解决方案

问题现象

在使用Earthly构建工具时，部分用户在Ubuntu 22.04系统下以Docker rootless模式运行时遇到了构建失败的问题。具体表现为执行earthly bootstrap命令时，虽然控制台显示"Bootstrapping successful"，但实际上buildkitd容器启动失败，并出现以下关键错误信息：

docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error running hook #0: fork/exec /proc/32697/exe: permission denied: unknown.

问题背景

Earthly是一个基于Docker的构建工具，它依赖于buildkitd容器来执行实际的构建任务。在Docker rootless模式下，用户以非root权限运行Docker守护进程，这种模式虽然提高了安全性，但可能会遇到一些权限相关的问题。

根本原因

该问题的根本原因在于Docker rootless模式下某些系统服务的状态异常。具体表现为：

1. Docker和containerd服务在用户空间运行时的权限配置出现问题
2. 系统服务可能处于不一致状态，导致容器运行时无法正确执行hook操作
3. 虽然Earthly检测到了错误，但错误处理逻辑不够完善，导致仍然显示"Bootstrapping successful"

解决方案

经过验证，可以通过以下步骤解决该问题：

systemctl --user --now disable docker
systemctl --user --now disable containerd
systemctl --user --now enable docker

这个解决方案的工作原理是：

1. 首先禁用用户空间运行的docker和containerd服务
2. 然后重新启用docker服务，这会连带启动必要的依赖服务
3. --now参数确保立即生效，不需要手动启动服务

预防措施

为避免类似问题再次发生，建议：

1. 定期检查Docker rootless模式下的服务状态
2. 在系统更新后验证Docker服务的正常运行
3. 考虑为Earthly配置更详细的日志输出，以便更早发现问题

技术细节

在Docker rootless模式下，所有操作都在用户命名空间内完成，这依赖于以下几个关键组件：

1. rootlesskit：提供用户命名空间功能
2. slirp4netns：提供网络功能
3. fuse-overlayfs：提供存储驱动

当这些组件中的任何一个出现问题时，都可能导致容器启动失败。本案例中的权限问题就是由于这些底层组件之间的协调出现了问题。

总结

虽然Earthly官方并未完全支持Docker rootless模式，但在大多数情况下仍能正常工作。遇到类似容器启动问题时，首先检查Docker服务状态是最有效的排查手段。对于Ubuntu系统用户，特别是22.04版本，在系统更新后出现类似问题时，可以尝试上述解决方案来恢复Earthly的正常工作。

对于长期使用Earthly的用户，建议关注项目的更新日志，特别是与Docker集成相关的改进，以获得更好的兼容性和稳定性。