History

Chen Chengjun bae5de9e8f Move test/* to test/initramfs/*		2026-01-13 11:53:34 -08:00
..
nix	Pin Nix channels and install cachix	2025-12-09 11:20:33 +08:00
Dockerfile	Move test/* to test/initramfs/*	2026-01-13 11:53:34 -08:00
README.md	Clean up TDX-specific Docker images	2025-08-15 15:27:09 +08:00
run_dev_container.sh	Support NixOS distro and add CI to test	2025-12-02 15:30:30 +08:00

README.md

Asterinas Development Docker Images

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

Building Docker Images

Asterinas development Docker image is based on an OSDK development Docker image. To build an Asterinas development Docker image and test it on your local machine, navigate to the root directory of the Asterinas source code tree and execute the following command:

cd <asterinas dir>
# Build Docker image
docker buildx build \
    -f tools/docker/Dockerfile \
    --build-arg ASTER_RUST_VERSION=$(grep "channel" rust-toolchain.toml | awk -F '"' '{print $2}') \
    --build-arg BASE_VERSION=$(cat DOCKER_IMAGE_VERSION) \
    -t asterinas/asterinas:$(cat DOCKER_IMAGE_VERSION) \
    .

Tagging and Uploading Docker Images

The Docker images are tagged according to the version specified in the DOCKER_IMAGE_VERSION file at the project root. Check out the version bump documentation on how new versions of the Docker images are released.