Add Dockerfile for an image with usable kmir/stable-mir-json installation (#517)

The image contains
- `kmir` installed using pip, on the path via `$HOME/.local/bin`
- semantics artefacts accessible to `kmir` (within `pip` data directory)
- `stable-mir-json` installation in `$HOME/.stable-mir-json`, on the
path as a soft-link in `$HOME/.local/bin`

The docker image has considerable size (6GB for me) because of the
`rustc` installation that `stable-mir-json` refers to. We could consider
leaving this part out of the image but there is no easy way to make it
much smaller - we have to ship `rustc`.

Usage:
```
# in repo root
me@mir-semantics$ git submodule update --init
me@mir-semantics$ docker buildx build --tag some/tag:$(cat package/version) --file Dockerfile.kmir --build-arg K_VERSION=$(cat deps/k_release) .

# takes about 2 minutes and 6GB

me@mir-semantics$ docker run --rm -it -v $PWD:/home/kmir/workspace -u $(id -u):$(id -g) some/tag:0.3.108 kmir prove run workspace/kmir/src/tests/integration/data/proving/unchecked-add-spec.k
Proving UNCHECKED-ADD-SPEC.unchecked-ADD-spec
APRProof: UNCHECKED-ADD-SPEC.unchecked-ADD-spec
    status: ProofStatus.PASSED
    admitted: False
    nodes: 4
    pending: 0
    failing: 0
    vacuous: 0
    stuck: 0
    terminal: 2
    refuted: 0
    bounded: 0
    execution time: 0s
Subproofs: 0
me@mir-semantics$  docker run --rm -it -v $PWD:/home/kmir/workspace -u $(id -u):$(id -g) rv/kmir:0.3.108  stable-mir-json --version
rustc 1.85.0-nightly (a2545fd6f 2024-11-28)
```

---------

Co-authored-by: devops <[email protected]>

Author: jberthold

Dockerfile.kmir

@@ -0,0 +1,65 @@
+ARG K_VERSION
+
+FROM runtimeverificationinc/kframework-k:ubuntu-jammy-$K_VERSION
+
+ARG K_VERSION
+
+# create non-root user and adjust UID:GID on start-up
+# see https://github.com/boxboat/fixuid
+RUN addgroup --gid 1000 kmir && \
+    adduser -uid 1000 --ingroup kmir --home /home/kmir --shell /bin/bash --disabled-password --gecos "" kmir
+RUN apt-get install -y curl graphviz python-is-python3 && \
+    USER=kmir && \
+    GROUP=kmir && \
+    curl -SsL https://github.com/boxboat/fixuid/releases/download/v0.6.0/fixuid-0.6.0-linux-amd64.tar.gz | tar -C /usr/local/bin -xzf - && \
+    chown root:root /usr/local/bin/fixuid && \
+    chmod 4755 /usr/local/bin/fixuid && \
+    mkdir -p /etc/fixuid && \
+    printf "user: $USER\ngroup: $GROUP\n" > /etc/fixuid/config.yml
+
+COPY kmir /kmir
+COPY deps/stable-mir-json /deps/stable-mir-json
+RUN chown -R kmir:kmir deps/stable-mir-json/
+
+USER kmir:kmir
+WORKDIR /home/kmir
+ENV K_VERSION=${K_VERSION} \
+    PATH=/home/kmir/.local/bin:/home/kmir/.cargo/bin:$PATH \
+    force_color_prompt=yes
+
+# install rustup non-interactively and build
+RUN curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain none
+
+# install kmir python parts and K definition/llvm library
+RUN cd /kmir && pip install . && kdist build mir-semantics.\*
+
+# build stable-mir-json and install into home
+# NB this will modify the default rust toolchain!
+# NB assumes submodule has been checked out!
+RUN cd /deps/stable-mir-json && \
+    cargo build && \
+    cargo build --release && \
+    cargo run --bin cargo_stable_mir_json -- $PWD && \
+    ln -s /home/kmir/.stable-mir-json/release.sh /home/kmir/.local/bin/stable-mir-json && \
+    cargo clean
+
+ENTRYPOINT ["fixuid", "-q"]
+
+CMD printf "%s\n" \
+    "Welcome to kmir, powered by K framework" \
+    "" \
+    "This docker image provides a K-framework installation with the following programs:" \
+    " * kompile" \
+    " * krun" \
+    " * kprove" \
+    " * kast" \
+    " * K backend tools (kore-*)" \
+    " * the pyk library to interact with K programmatically " \
+    "" \
+    "as well as a pre-installed kmir tool and stable-mir-json" \
+    "" \
+    "To use this docker image, start a container with an interactive shell and" \
+    "a working directory with your working directory mounted into it, like so:" \
+    "" \
+    'user@host$ docker run --rm -it -v "$PWD":/home/kmir/workspace -u $(id -u):$(id -g) <docker-image> /bin/bash' \
+    ""

kmir/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "kmir"
-version = "0.3.109"
+version = "0.3.110"
 description = ""
 authors = [
     "Runtime Verification, Inc. <[email protected]>",

kmir/src/kmir/__init__.py

@@ -1,3 +1,3 @@
 from typing import Final
 
-VERSION: Final = '0.3.109'
+VERSION: Final = '0.3.110'

package/version

@@ -1 +1 @@
-0.3.109
+0.3.110