QSmally / Zig-Build

Image to compile and run Zig

Zig-Build

Image to compile and run Zig.

An alpine image containing the output binary of zig build from a multi-stage build. A couple of build args may be supplied to adjust the compilation process by the image; VERSION (0.11.0 default), OPTIONS (-Doptimize=ReleaseSafe default).

Usage

A compose service may look something like the following, running it with $ docker compose up.

services:
    application:
      restart: always
      build: . # Dockerfile, build.zig, Sources/
      container_name: application
      entrypoint: /bin/<executable>

Cross-compilation

Say you're compiling from darwin/aarch64 (macOS M-series) and need to build a deployment image to run on your Debian Linux server on x64, you can easily specify the final stage's target platform as well as the compilation target that compiles on your native machine (using the awesome capabilities of the Zig compiler). Having the multi-stage build removes the need for (often slow) virtualisation.

Below compiles an image for linux/amd64 with a x86_64-linux-musl (static) binary.

$ platform="linux/amd64"
$ options="-Doptimize=ReleaseSafe -Dtarget=x86_64-linux-musl"
$ docker build \
    --build-arg "TARGETPLATFORM=$platform" \
    --build-arg "OPTIONS=$options" \
    -t application .