Jinux Development Docker Images

Jinux development Docker images are provided to facilitate developing and testing Jinux project. These images can be found in the jinuxdev/jinux repository on DockerHub.

Building Docker Images

To build a Docker image for Jinux and test it on your local machine, navigate to the root directory of the Jinux source code tree and execute the following command:

docker buildx build \
    -f tools/docker/Dockerfile.ubuntu22.04 \
    --build-arg JINUX_RUST_VERSION=$RUST_VERSION \
    -t jinuxdev/jinux:$JINUX_VERSION \
    .

The meanings of the two environment variables in the command are as follows:

$JINUX_VERSION: Represents the version number of Jinux. You can find this in the VERSION file.
$RUST_VERSION: Denotes the required Rust toolchain version, as specified in the rust-toolchain file.

Tagging Docker Images

It's essential for each Jinux Docker image to have a distinct tag. By convention, the tag is assigned with the version number of the Jinux project itself. This methodology ensures clear correspondence between a commit of the source code and its respective Docker image.

If a commit needs to create a new Docker image, it should

Update the Dockerfile as well as other materials relevant to the Docker image, and
Run tools/bump_version.sh tool to update the Jinux project's version number.

For bug fixes or small changes, increment the last number of a SemVer by one. For major features or releases, increment the second number. All changes made in the two steps should be included in the commit.

Uploading Docker Images

New versions of Jinux's Docker images are automatically uploaded to DockerHub through Github Actions. Simply submit your PR that updates Jinux's Docker image for review. After getting the project maintainers' approval, the Docker image building workflow will be started, building the new Docker image and pushing it to DockerHub.