Earthly项目中TRY/FINALLY与WITH DOCKER结合使用的输出优化

在Earthly构建工具中，当开发者使用TRY/FINALLY语句块与WITH DOCKER指令结合时，会产生较为冗长的错误输出信息。这个问题虽然不影响功能执行，但会对开发者的调试体验造成一定困扰。

问题现象

当在Earthfile中使用如下结构时：

VERSION --try 0.8

test:
  FROM earthly/dind:alpine
  TRY
    WITH DOCKER
      RUN echo important > data && false
    END
  FINALLY
    SAVE ARTIFACT data AS LOCAL ./data
  END

执行后会输出大量调试信息，包括完整的docker命令执行路径和环境变量等详细信息。相比之下，不使用WITH DOCKER的简单TRY/FINALLY结构则会产生简洁得多的错误输出。

技术背景

Earthly是一个基于Docker的构建工具，它通过定义Earthfile来描述构建过程。TRY/FINALLY是Earthly提供的一种错误处理机制，允许在命令失败后仍然执行必要的清理或保存操作。WITH DOCKER则用于在构建过程中启动一个临时的Docker守护进程。

当这两个特性结合使用时，由于WITH DOCKER内部涉及复杂的Docker环境设置和命令执行过程，导致错误输出包含了大量底层实现细节，这对大多数开发者来说是不必要的噪音。

解决方案

Earthly团队已经意识到这个问题，并在内部进行了修复。主要改进方向包括：

1. 简化错误输出信息，去除不必要的底层细节
2. 保持核心错误信息的清晰可见
3. 确保TRY/FINALLY的功能完整性不受影响

修复后的版本将提供更符合开发者预期的错误输出体验，同时仍然保留所有必要的调试信息供高级用户使用。

最佳实践

对于需要在Docker环境中执行命令并确保资源清理的场景，建议采用以下结构：

VERSION 0.8
test:
    ARG FRONTEND=docker
    FROM alpine:3.18
    TRY
        WITH DOCKER
            RUN $FRONTEND ps > docker-ps && false
        END
    FINALLY
        SAVE ARTIFACT docker-ps AS LOCAL .testdata
    END

这种结构既保证了命令在Docker环境中执行，又能利用TRY/FINALLY进行必要的资源清理或结果保存，同时避免了过于冗长的错误输出。

总结

Earthly团队持续优化开发者体验，这次对TRY/FINALLY与WITH DOCKER结合使用的输出优化，体现了对构建工具可用性的重视。开发者可以期待在未来的版本中获得更清晰、更有针对性的错误提示信息，从而提高开发效率。