feat: all in one

Author: zhzLuke96

.github/workflows/build-kernel.yml

@@ -0,0 +1,68 @@
+name: Build WSL2 Kernel
+
+on:
+  workflow_dispatch:
+    inputs:
+      kernel_version:
+        description: "WSL2 kernel version (e.g. 5.15.150.1)"
+        required: true
+        default: "5.15.150.1"
+      extra_config:
+        description: "Extra kernel config options (e.g. CONFIG_USB_VIDEO_CLASS=y)"
+        required: false
+        default: ""
+  schedule:
+    - cron: "0 0 * * 0" # Weekly builds
+
+env:
+  ARTIFACT_NAME: wsl2-kernel
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Set up build environment
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential flex bison dwarves libssl-dev libelf-dev libncurses-dev
+
+      - name: Download kernel source
+        run: |
+          mkdir kernel
+          cd kernel
+          wget https://github.com/microsoft/WSL2-Linux-Kernel/archive/refs/tags/linux-msft-wsl-${{ github.event.inputs.kernel_version }}.tar.gz
+          tar -xzf linux-msft-wsl-${{ github.event.inputs.kernel_version }}.tar.gz
+          mv WSL2-Linux-Kernel-linux-msft-wsl-${{ github.event.inputs.kernel_version}} linux-${{ github.event.inputs.kernel_version }}
+          echo "KERNEL_SRC=$(pwd)/linux-${{ github.event.inputs.kernel_version }}" >> $GITHUB_ENV
+
+      - name: Configure kernel
+        run: |
+          cd $KERNEL_SRC
+          cp Microsoft/config-wsl .config
+          # Apply extra config if provided
+          if [ -n "${{ github.event.inputs.extra_config }}" ]; then
+            echo "${{ github.event.inputs.extra_config }}" >> .config
+          fi
+          make olddefconfig
+
+      - name: Build kernel
+        run: |
+          cd $KERNEL_SRC
+          make -j$(nproc)
+
+      - name: Package artifact
+        run: |
+          mkdir -p $ARTIFACT_NAME
+          cp $KERNEL_SRC/arch/x86/boot/bzImage $ARTIFACT_NAME/bzImage
+          cp $KERNEL_SRC/.config $ARTIFACT_NAME/config
+          echo "Kernel version: ${{ github.event.inputs.kernel_version }}" > $ARTIFACT_NAME/version.txt
+          echo "Build date: $(date)" >> $ARTIFACT_NAME/version.txt
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: ${{ env.ARTIFACT_NAME }}-${{ github.event.inputs.kernel_version }}
+          path: $ARTIFACT_NAME

README.md

@@ -1,2 +1,52 @@
-# lets-build-wsl2-kernels
+# WSL2 Kernel Builder
+
 This repository automates building custom WSL2 kernels using GitHub Actions.
+
+## Features
+
+- Build any WSL2 kernel version from Microsoft's repository
+- Manual trigger with custom version and config options
+- Weekly automatic builds of the latest stable version
+- Artifact with compiled kernel and config
+
+## Usage
+
+### Manual Build via GitHub UI
+
+1. Go to "Actions" tab
+2. Select "Build WSL2 Kernel"
+3. Click "Run workflow"
+4. Specify kernel version (e.g. `5.15.150.1`)
+5. (Optional) Add extra config options (e.g. `CONFIG_USB_VIDEO_CLASS=y`)
+6. Click "Run workflow"
+
+### Download and Use Built Kernel
+
+1. After build completes, download the artifact
+2. Extract the `bzImage` file
+3. Place it in your desired location (e.g. `C:\Windows\System32\lxss\tools`)
+4. Create or modify `%USERPROFILE%\.wslconfig`:
+
+```ini
+[wsl2]
+kernel=C:\\path\\to\\bzImage
+```
+
+5. Restart WSL: `wsl --shutdown`
+
+### Local Build
+
+To build locally, run:
+
+```bash
+./scripts/build.sh [version] [extra_config]
+```
+
+Example:
+```bash
+./scripts/build.sh 5.15.150.1 "CONFIG_USB_VIDEO_CLASS=y"
+```
+
+## Supported Versions
+
+Check available versions at [Microsoft's WSL2-Linux-Kernel repository](https://github.com/microsoft/WSL2-Linux-Kernel/tags)

scripts/build.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+set -e
+
+KERNEL_VERSION=${1:-"5.15.150.1"}
+EXTRA_CONFIG=${2:-""}
+
+# Install dependencies
+sudo apt-get update
+sudo apt-get install -y build-essential flex bison dwarves libssl-dev libelf-dev libncurses-dev
+
+# Download kernel source
+mkdir -p kernel
+cd kernel
+wget https://github.com/microsoft/WSL2-Linux-Kernel/archive/refs/tags/linux-msft-wsl-${KERNEL_VERSION}.tar.gz
+tar -xzf linux-msft-wsl-${KERNEL_VERSION}.tar.gz
+mv WSL2-Linux-Kernel-linux-msft-wsl-${KERNEL_VERSION} linux-${KERNEL_VERSION}
+cd linux-${KERNEL_VERSION}
+
+# Configure kernel
+cp Microsoft/config-wsl .config
+
+if [ -n "${EXTRA_CONFIG}" ]; then
+    echo "${EXTRA_CONFIG}" >> .config
+fi
+
+make olddefconfig
+
+# Build kernel
+make -j$(nproc)
+
+echo "Build completed successfully!"
+echo "Kernel image: $(pwd)/arch/x86/boot/bzImage"