rust-vmm-container

rustvmm/dev is a container with all dependencies used for running rust-vmm integration tests.

The container is available on Docker Hub and has support for x86_64 and aarch64 platforms.

docker pull rustvmm/dev:v3

For the latest available tag, please check the rustvmm/dev builds available on Docker Hub.

Depending on which platform you're running the command from, docker will pull either rustvmm/dev:v3_aarch64 or rustvmm/dev:v3_x86_64.

For now rust is installed only for the root user.

Using the Container

The container is currently used for running the integration tests for the kvm-ioctls crate.

Example of running cargo build on the kvm-ioctls crate:

> git clone git@github.com:rust-vmm/kvm-ioctls.git
> cd kvm-ioctls/
> docker run --volume $(pwd):/kvm-ioctls \
         rustvmm/dev:v3 \
         /bin/bash -c "cd /kvm-ioctls && cargo build --release"
 Downloading crates ...
  Downloaded libc v0.2.48
  Downloaded kvm-bindings v0.1.1
   Compiling libc v0.2.48
   Compiling kvm-bindings v0.1.1
   Compiling kvm-ioctls v0.0.1 (/kvm-ioctls)
    Finished release [optimized] target(s) in 5.63s

Available Tools

The container currently has the Rust toolchain version 1.35.0 and Python3.6.

Python packages:

• pip3
• pytest

Cargo plugins:

• rustfmt
• cargo-kcov
• clippy

Rust targets on x86_64:

• x86_64-unknown-linux-gnu
• x86_64-unknown-linux-musl

Rust targets on aarch64:

• aarch64-unknown-linux-gnu
• aarch64-unknown-linux-musl

Publishing a New Version

In this example, we assume the current version is v3 and we want to publish a newer v4 container version.

On an aarch64 platform:

> cd rust-vmm-dev-container
> # Build a container image for aarch64
> docker build -t rustvmm/dev:v4_aarch64 -f Dockerfile .
> docker images
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
rustvmm/dev            aarch64             f3fd02dfb213        21 hours ago        1.13GB
ubuntu                 18.04               0926e73e5245        3 weeks ago         80.4MB
>
> docker tag f3fd02dfb213 rustvmm/dev:v4_aarch64
> docker push rustvmm/dev:v4_aarch64

You will need to redo all steps on a x86_64 platform so the containers are kept in sync (same package versions on both x86_64 and aarch64).

> docker build -t rustvmm/dev:v4_x86_64 -f Dockerfile .
> docker tag XXXXXXXX rustvmm/dev:v4_x86_64
> docker push rustvmm/dev:v4_x86_64

Now that the tags v4_x86_64 and v4_aarch64 are pushed to Docker Hub, we can go ahead and also create a new version tag that points to these two builds using docker manifest.

docker manifest create \
        rustvmm/dev:v4 \
        rustvmm/dev:v4_x86_64 \
        rustvmm/dev:v4_aarch64
docker manifest push rustvmm/dev:v4

If it is the first time you are creating a docker manifest, most likely it will fail with: docker manifest is only supported when experimental cli features are enabled. Checkout this article to understand why and how to fix it.