2.3 KiB
构建说明
由于 kkfileview 的基础运行环境很少变动且制作耗时较久，而 kkfileview 本身代码开发会频繁改动，因此把制作其 Docker 镜像的步骤拆分为两次：
首先制作 kkfileview 的基础镜像（kkfileview-base）。
然后使用 kkfileview-base 作为基础镜像进行构建，加快 kkfileview docker 镜像构建与发布。
执行如下命令即可构建基础镜像：
这里镜像 tag 以 4.4.0 为例，本项目所维护的 Dockerfile 文件考虑了跨平台兼容性。 如果你需要用到 arm64 架构镜像, 则在arm64 架构机器上同样执行下面的构建命令即可
docker build --tag keking/kkfileview-base:4.4.0 .
跨平台构建
docker buildx 支持在一台机器上构建出多种平台架构的镜像。推荐使用该能力进行跨平台的镜像构建。
例如，执行 docker buildx build 命令时加上 --platform=linux/arm64 参数即可构建出 arm64 架构镜像。这极大方便了那些没有arm64 架构机器却想构建 arm64 架构镜像的用户。
当前本项目仅支持构建 linux/amd64 和 linux/arm64 两种平台架构的镜像 buildx 的 builder driver 可以使用默认的
docker类型, 若使用docker-container类型可以支持并行构建多种架构, 本文不再赘述, 有兴趣可以自行了解。参考 Docker Buildx | Docker Documentation
前提要求
以当前机器为 amd64 (x86_64)架构为例。需要开启 docker 的 buildx 特性，以及开启 Linux 的 QEMU 用户模式：
使用 WSL2 的 Windows 用户如果安装了最新的 DockerDesktop, 则这些前提要求已满足, 无需额外下述设置。
-
安装 docker buildx 客户端插件：
docker 版本要求 >=19.03
若已安装, 则跳过。详情参考 https://github.com/docker/buildx
-
开启 QEMU 的用户模式功能, 并安装其它平台的模拟器:
Linux 内核要求 >=4.8
使用
tonistiigi/binfmt镜像可快速开启并安装模拟器，执行下面命令:docker run --privileged --rm tonistiigi/binfmt --install all
现在就可以愉快地开始构建了，构建命令示例:
docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:4.4.0 --push .