alexandreteles/cblmariner repository overview

⁠CBL-Mariner 2.0 base image for WSL2

⁠DESCRIPTION

This is a simple image based on CBL-Mariner 2.0 that incorporates into the provided Docker image the base tools required to run a full server instead of a purpose-built container. Please note that if you want to run simple containers THIS IS NOT THE IMAGE YOU'RE LOOKING FOR.

To run containers based on CBL-Mariner please use Microsoft's official container base image. Ex.:

FROM cblmariner.azurecr.io/base/core:2.0

...

This will give you a relatively small (~68MB) base image upon which you can build your containers.

We provide this image for three main reasons:

1. If you wan't to run CBL-Mariner containers on CBL-Mariner and need a testing platform;
2. So users can get used to the process of designing and running servers using CBL-Mariner, and;
3. Because it's fun.

Please note that CBL-Mariner relies on a very small package repository when compared with other Enterprise Linux distributions (ex.: RHEL) so you might have to compile your own packages in which case having a WSL2 ready base image will help your test and debug process.

Nvidia drivers and Docker integration should work out of the box.

⁠INSTALLATION

Installing this distribution is easy and straightforward:

1. Create a directory where WSL will store the filesystem for this distribution:

mkdir C:\WSL\CBL-Mariner

1. Pull the image from Docker Hub:

docker pull alexandreteles/cblmariner:2.0

1. Create a container:

docker create --name cblmariner -t -i alexandreteles/cblmariner:2.0 bash 

1. Export the container:

docker export --output="cblmariner.tar" cblmariner

1. Import the image into WSL:

wsl --import CBL-Mariner C:\WSL\CBL-Mariner ./cblmariner.tar

WSL will create a VHDX virtual disk, import the .tar file and expand the filesystem into it (~730MB). Once the process is completed you can start the container as usual, be it directly from the WSL shell or from a Windows terminal.

⁠ADDITIONAL INFORMATION

Below you'll find a list of the additional packages included on top of the core-packages-container already included on the Docker base image:

For more information about the packages intalled by the meta-package core-packages-base-image or about CBL-Mariner in general, please refer to the official GitHub repository for the project at https://github.com/microsoft/CBL-Mariner⁠

• GitHub repo: https://github.com/INCT-DD/cblmariner-wsl2⁠