earthly/buildkitd 镜像文档

镜像概述

本镜像包含带有Earthly特定配置的buildkit，是Earthly使用本地守护进程时启动的组件。也可手动启动并作为远程/共享的BuildKit守护进程使用。

注意：本容器版本仅与对应版本的earthly测试过，不支持版本不匹配的情况。

标签

当前，latest标签对应版本为v0.8.13。
其他可用标签请查看 [***]

快速开始

以下是覆盖最常见用例的docker run命令示例：

简单使用（本地使用）

bash
docker run --privileged -t -v earthly-tmp:/tmp/earthly:rw earthly/buildkitd:v0.7.19

参数说明：

• --privileged：必需，Earthly需要buildkit的某些特权功能。
• -t：让Docker模拟TTY，使buildkit日志输出彩色化。
• -v earthly-tmp:/tmp/earthly:rw：将earthly-tmpDocker卷挂载到容器的/tmp/earthly（若不存在则创建），用作buildkitd构建期间的临时/工作目录。

在本地运行时，可通过设置EARTHLY_BUILDKIT_HOST=docker-container://<容器名称>或在config.yml中指定相应值来使用此buildkitd。

远程使用

bash
docker run --privileged -t -v earthly-tmp:/tmp/earthly:rw -e BUILDKIT_TCP_TRANSPORT_ENABLED=true -p 8372:8372 earthly/buildkitd:v0.7.19

新增参数说明（已讨论的参数不再重复）：

• -e BUILDKIT_TCP_TRANSPORT_ENABLED=true：使buildkitd监听TCP端口而非Unix socket。
• -p 8372:8372：将主机端口8372转发到容器端口8372。使用TCP时，buildkit始终监听8372，可通过转发不同主机端口修改对外端口。

若在名为fast-builder的机器上运行，可通过设置EARTHLY_BUILDKIT_HOST=tcp://fast-builder:8372或在config.yml中指定地址来使用此远程buildkitd。

使用说明

要求

特权模式

本镜像需以特权容器运行，因为buildkitd需要通过runc启动和运行其他容器的适当权限。

/tmp/earthly目录

由于该目录有大量读写操作，保持其高速访问至关重要。强烈建议使用Docker卷挂载/tmp/earthly。若不使用，buildkitd可能会消耗过多磁盘空间、运行缓慢或无法正常工作。

在某些环境中，未将/tmp/earthly挂载为Docker卷可能导致以下错误：

--> WITH DOCKER RUN --privileged ...
...
rm: can't remove '/var/earthly/dind/...': Resource busy

外部使用

要外部使用本镜像，需将主机端口转发到容器的8372端口，并确保外部可访问该主机端口。

本地使用earthly时，若EARTHLY_BUILDKIT_HOST设置为127.0.0.1、::1/128或localhost，Earthly会认为是本地并尝试自行管理BuildKit容器。建议使用主机名或其他替代名称。

支持的环境变量