Earthly项目中通过WITH DOCKER指令复用多容器镜像的最佳实践

在Earthly项目中构建复杂的容器化测试环境时，经常需要同时启动多个相互依赖的服务容器。Earthly提供的WITH DOCKER指令结合--compose参数可以很好地解决这个问题，但如何高效地复用项目中已构建的镜像是一个值得探讨的技术点。

多阶段构建中的镜像复用

Earthly的构建过程支持多阶段构建模式，每个构建目标(Target)可以独立构建并输出镜像。例如在CI/CD流水线中，我们可能会分别构建数据库服务、消息队列服务和应用程序服务：

FROM alpine:latest
WORKDIR /test

ci-mariadb:
    FROM mariadb:latest
    SAVE IMAGE ci-env:mariadb

ci-nats:
    FROM nats:latest
    SAVE IMAGE ci-env:nats

ci-e2e:
    FROM xxxx
    SAVE IMAGE e2e:latest

WITH DOCKER指令的镜像加载机制

在集成测试阶段，我们需要同时启动这些服务容器。Earthly的WITH DOCKER指令提供了--load参数，可以显式加载其他构建阶段生成的镜像：

ci-test:
    FROM earthly:dind
    WITH DOCKER --compose docker-compose.yaml \
                --load ci-env:mariadb=+ci-mariadb \
                --load ci-env:nats=+ci-nats \
                --load e2e:latest=+ci-e2e
        RUN docker run --rm e2e:latest 
    END

关键技术要点

1. 镜像标签映射：--load参数支持将构建目标输出的镜像重新打标签，格式为<new-tag>=<target-ref>

2. 多镜像加载：可以多次使用--load参数来加载多个不同构建阶段生成的镜像

3. Compose文件集成：配合--compose参数，可以在Docker Compose配置中直接引用这些已加载的镜像

services:
    mariadb:
        image: ci-env:mariadb
    nats:
        image: ci-env:nats

实际应用建议

1. 镜像命名规范：建议为CI环境使用的镜像建立统一的命名规范，如示例中的ci-env:前缀

2. 构建顺序优化：Earthly会自动解析依赖关系，但明确的目标引用使构建流程更清晰

3. 缓存利用：合理使用SAVE IMAGE和--load组合可以充分利用Earthly的缓存机制

通过这种模式，开发者可以在Earthly项目中高效地构建和管理复杂的多容器测试环境，同时保持构建过程的模块化和可维护性。