file-online-preview/docker/kkfileview-base/README.cn.md

构建说明

由于 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, 则这些前提要求已满足, 无需额外下述设置。

1. 安装 docker buildx 客户端插件：

   docker 版本要求 >=19.03

   若已安装, 则跳过。详情参考 https://github.com/docker/buildx

2. 开启 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 .