Skip to content

wsl-buildenv.md

Latest commit

 

History

History
49 lines (37 loc) · 1.58 KB

wsl-buildenv.md

File metadata and controls

49 lines (37 loc) · 1.58 KB

Prepare WSL Build Environment

The build scripts make use of overlayfs and require root privileges, so AN EXCLUSIVE WSL 2 DISTRO is required.

Install WSL

See Microsoft Learn.

Create an Exclusive Distro

  1. Download Ubuntu 24.04 WSL rootfs tarball from Ubuntu CD Images.
  2. Import it into WSL, for example: 
    wsl --import mingw-lite-buildenv C:\wsl\mingw-lite-buildenv Downloads\noble-wsl-amd64.wsl
  3. Restart Windows Terminal. “mingw-lite-buildenv” now appears in the dropdown list.

Install Dependencies

  1. Launch the exclusive distro (launch “Terminal”, select “mingw-lite-buildenv” from the dropdown list).
  2. Install required packages: 
    apt update
apt install --no-install-recommends -y \
  autoconf automake build-essential cmake flex gettext libtool llvm ninja-build texinfo \
  7zip ca-certificates curl file gawk libarchive-tools python3 python3-libarchive-c python3-packaging zstd

Clone the Repository

Cloning to Windows filesystem is recommended. For example with Windows Git Bash:

git clone https://github.com/redpanda-cpp/mingw-lite.git /d/mingw-lite --config core.autocrlf=false --config core.symlinks=true

core.autocrlf must be disabled, and core.symlinks must be enabled. To convert an existing repo, run:

# save workspace
git add *
git stash

# do convertion
git config core.autocrlf false
git config core.symlinks true
git reset --hard

# restore workspace
git stash pop