earthly/dind

Earthly dind 镜像文档

镜像概述

dind（Docker-in-Docker）镜像专为使用 WITH DOCKER 命令的 Earthfile 目标设计。详细信息请参考 "use-earthly-dind" 最佳实践。

核心功能与特性

• 支持 Docker-in-Docker 功能，满足 Earthfile 中 WITH DOCKER 命令的运行需求
• 提供多种 Linux 发行版支持，适配不同环境需求
• 版本化标签设计，便于精确控制镜像版本

标签信息

支持的 Linux 发行版

该镜像支持以下 3 种 Linux 发行版：

• alpine
• ubuntu:20.04
• ubuntu:23.04
• ubuntu:24.04

最新标签

各发行版对应的当前最新标签分别为：

• alpine-3.20-docker-26.1.5-r0
• ubuntu-20.04-docker-27.2.1-1
• ubuntu-23.04-docker-25.0.2-1
• ubuntu-24.04-docker-27.3.1-1

其他可用标签请查看 https://hub.docker.com/r/earthly/dind/tags%E3%80%82

过时标签

以下标签已过时：

• alpine
• ubuntu

注意事项

• 过时的 ubuntu 镜像与 Earthly v0.7.14 不兼容（在 v0.7.15 中已修复）
• alpine 镜像曾与 v0.7.14 不兼容，但已通过向后兼容的修复解决
• 建议用户今后固定使用特定版本标签，未版本化的标签将保持现状以避免向后不兼容变更

版本过渡示例

为便于版本过渡，可使用依赖 EARTHLY_VERSION 内置参数的 IF 命令：

VERSION 0.8

dind:
  FROM earthly/dind:alpine
  ARG EARTHLY_VERSION
  ARG SMALLEST_VERSION="$(echo -e "$EARTHLY_VERSION\nv0.7.14" | sort -V | head -n 1)"
  IF [ "$SMALLEST_VERSION" = "v0.7.14" ]
    # Earthly 版本为 v0.7.14 或更新，必须使用较新的 dind:alpine-3.19-docker-25.0.2-r0 镜像
    FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
  END

test:
  FROM +dind
  WITH DOCKER
    RUN docker --version # 旧版本 Earthly 将获取 20.10.14，新版本将获取 23.0.6
  END

使用场景

适用于需要在 Earthly 构建流程中使用 Docker 命令的场景，如：

• 在构建过程中构建、测试或推送 Docker 镜像
• 需在隔离环境中运行 Docker 命令的 CI/CD 流程
• 需要与 Earthly 构建系统深度集成的 Docker 相关操作