54 lines
2.7 KiB
Java
54 lines
2.7 KiB
Java
# Build Instructions
|
||
|
||
Since the base runtime environment for kkfileview rarely changes and takes a long time to build, while the kkfileview code itself is frequently updated, the process of building its Docker image is split into two steps:
|
||
|
||
First, create the base image for kkfileview (kkfileview-base).
|
||
|
||
Then, use kkfileview-base as the base image to build and speed up the kkfileview Docker image build and release process.
|
||
|
||
To build the base image, run the following command:
|
||
|
||
> In this example, the image tag is 4.4.0. The Dockerfile maintained in this project considers cross-platform compatibility. If you need an arm64 architecture image, run the same build command on an arm64 architecture machine.
|
||
|
||
```shell
|
||
docker build --tag keking/kkfileview-base:4.4.0 .
|
||
```
|
||
|
||
|
||
|
||
## Cross-Platform Build
|
||
|
||
`docker buildx` supports building images for multiple platform architectures on a single machine. It is recommended to use this capability for cross-platform image builds.
|
||
For example, adding the `--platform=linux/arm64` parameter when executing the `docker buildx build` command will allow you to build an arm64 architecture image. This is particularly convenient for users who want to build arm64 images but don't have an arm64 machine.
|
||
|
||
> Currently, this project only supports building images for the linux/amd64 and linux/arm64 architectures.
|
||
> The buildx builder driver can use the default `docker` type, but if you use the `docker-container` type, you can build multiple architectures in parallel. This README will not cover that in detail, you can learn more on your own. Refer to [Docker Buildx | Docker Documentation](https://docs.docker.com/buildx/working-with-buildx/#build-multi-platform-images)
|
||
|
||
**Prerequisites**
|
||
|
||
Assuming the current machine is amd64 (x86_64) architecture, you'll need to enable the docker buildx feature and enable Linux QEMU user mode:
|
||
|
||
> Windows users with WSL2 who have installed a recent version of Docker Desktop will already meet these prerequisites, so no additional setup is required.
|
||
|
||
1. Install the docker buildx client plugin:
|
||
|
||
> Docker version >=19.03 is required.
|
||
|
||
If it's already installed, you can skip this step. For more details, refer to https://github.com/docker/buildx.
|
||
|
||
2. Enable QEMU user mode and install emulators for other platforms:
|
||
|
||
> Linux kernel version >=4.8 is required.
|
||
|
||
You can quickly enable and install emulators using the tonistiigi/binfmt image by running the following command:
|
||
|
||
```shell
|
||
docker run --privileged --rm tonistiigi/binfmt --install all
|
||
```
|
||
|
||
Now you can enjoy the building. Here’s an example build command:
|
||
|
||
```shell
|
||
docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:4.4.0 --push .
|
||
```
|