Containerd镜像构建工具以及简单使用

获取地址：https://github.com/moby/buildkit/releases

 

BuildKit 由buildkitd守护进程和buildctl客户端组成。虽然buildctl客户端可用于 Linux、macOS 和 Windows，但buildkitd守护程序目前仅可用于 Linux。

 

启动buildkitd守护进程：

您需要buildkitd在主机上以 root 用户身份运行。（默认前台执行）

$ sudo buildkitd

 

要buildkitd以非 root 用户身份运行，参考https://github.com/moby/buildkit/blob/master/docs/rootless.md

 

buildkitd 守护进程支持两个工作后端：OCI (runc) 和 containerd。

默认情况下，使用 OCI (runc) 后端工作。可以设置--oci-worker=false --containerd-worker=true使用 containerd 后端。

 

buildkitd --oci-worker=false --containerd-worker=true & 

 

用systemd管理，参考https://github.com/moby/buildkit#systemd-socket-activation

 

前端是在 BuildKit 中运行并将任何构建定义转换为 LLB 的组件。有一个名为 gateway ( gateway.v0)的特殊前端，它允许使用任何图像作为前端。（LLB二进制中间格式）

在开发过程中，Dockerfile 前端 ( dockerfile.v0) 也是 BuildKit 存储库的一部分。将来，这将被移出，并且可以使用外部映像构建 Dockerfile。

 

构建一个 Dockerfile buildctl

 

buildctl build \
    --frontend=dockerfile.v0 \
    --local context=. \
    --local dockerfile=.

# or

buildctl build \
    --frontend=dockerfile.v0 \
    --local context=. \
    --local dockerfile=. \
    --opt target=foo \
    --opt build-arg:foo=bar

 

--local 将本地源文件从客户端公开给构建器(就是特喵的目录)。

context是 Dockerfile 前端查找构建上下文，比如在从目录中拷贝文件到镜像里

Dockerfile 构建文件的位置目录。

--output 的 name 表示构建的镜像名称，镜像会存在本地containerd的buildkit命名空间下

 

buildkit命名空间在配置文件worker.containerd.namespace,要修改此命名空间, 可以去配置 /etc/buildkit/buildkitd.toml

 

 

显示本地构建缓存 ( /var/lib/buildkit )

 

如果需要凭据，buildctl将尝试读取 Docker 配置文件$DOCKER_CONFIG/config.json。 $DOCKER_CONFIG默认为~/.docker.

 

构建推送到registry

 

buildctl build \
    --frontend=dockerfile.v0 \
    --local context=. \
    --local dockerfile=. \
    --output type=image,name=docker.io/username/image:tag,push=true

 

name=[value]: 图像名称
push=true: 创建镜像后推送
push-by-digest=true: 推送未命名的图像
registry.insecure=true: 推送到不安全的 HTTP 注册中心
oci-mediatypes=true: 在配置 JSON 中使用 OCI 媒体类型而不是 Docker 的
unpack=true：创建后解压镜像（用于containerd）
dangling-name-prefix=[value]: 用 命名图像prefix@<digest>，用于匿名图像
name-canonical=true: 添加额外的规范名称 name@<digest>
compression=[uncompressed,gzip,estargz,zstd]: 为新创建和缓存的图层选择压缩类型，gzip 为默认值。esargz 应与oci-mediatypes=true.
force-compression=true：强制将compression选项应用于所有图层（包括已经存在的图层）。
buildinfo=[all,imageconfig,metadata,none]：选择要导出的构建依赖版本（默认all）。

 

使用缓存构建镜像并推送到registry

 

inline: 将缓存嵌入到镜像中，一起推送到注册表中

registry: 分别推送镜像和缓存

local: 导出到本地目录

gha: 导出到 GitHub Actions 缓存

 

buildctl build \
    --frontend=dockerfile.v0 \
    --local context=. \
    --local dockerfile=. \
    --output type=image,name=docker.io/username/image:tag,push=true
    --export-cache type=inline

 

将缓存一起推送到registry，registry需要type才能导入缓存，应该指定--export-cache type=inline和--import-cache type=registry,ref=docker.io/username/image。要将缓存导出到本地目录，应该指定--export-cache type=local

 

--export-cache 选项：

　　type=registry
　　mode=min （默认）：仅导出结果图像的图层
　　mode=max：导出所有中间步骤的所有层。
　　ref=docker.io/user/image:tag： 参考
　　oci-mediatypes=true|false: 是否在导出的清单中使用 OCI 媒体类型。由于 BuildKitv0.8默认为 true。

--import-cache 选项：

　　type=registry
　　ref=docker.io/user/image:tag