Add NixOS support, CHANGLOG and other changes

.github/workflows/build.yml

@@ -0,0 +1,139 @@
+name: Build Nix Packages
+
+on:
+  push:
+    branches: [ main, master ]
+    tags:
+      - '[0-9]*.[0-9]*.[0-9]*'
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - system: aarch64-linux
+            package: microhop
+            runs-on: ubuntu-latest
+          - system: aarch64-linux
+            package: microhop
+            runs-on: ubuntu-latest
+          - system: x86_64-linux
+            package: microhop
+            runs-on: ubuntu-latest
+
+    runs-on: ${{ matrix.runs-on }}
+    name: Build ${{ matrix.package }} (${{ matrix.system }})
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v27
+        with:
+          extra_nix_config: |
+            experimental-features = nix-command flakes
+            extra-platforms = aarch64-linux x86_64-linux
+
+      - name: Setup Cachix
+        uses: cachix/cachix-action@v15
+        with:
+          name: microhop
+          authToken: '${{ secrets.CACHIX_AUTH_TOKEN }}'
+          skipPush: ${{ github.event_name == 'pull_request' }}
+        continue-on-error: true
+
+      - name: Configure QEMU for cross-compilation
+        if: runner.os == 'Linux' && matrix.system == 'aarch64-linux'
+        run: |
+          sudo apt-get update -q
+          sudo apt-get install -y qemu-user-static binfmt-support
+
+      - name: Build package
+        run: |
+          nix build .#packages.${{ matrix.system }}.${{ matrix.package }} -L
+
+      - name: Check build output
+        run: |
+          ls -lah result/
+          nix path-info .#packages.${{ matrix.system }}.${{ matrix.package }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.package }}-${{ matrix.system }}
+          path: result/
+          retention-days: 7
+
+  release:
+    name: Create Release
+    if: startsWith(github.ref, 'refs/tags/') && contains(github.ref, '.')
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Extract changelog for version
+        id: changelog
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+
+          CHANGELOG=$(awk "/## \[$VERSION\]/,/## \[/" CHANGELOG.md | sed '1d;$d' | sed '/^$/d')
+
+          if [ -z "$CHANGELOG" ]; then
+            CHANGELOG=$(awk "/## \[Unreleased\]/,/## \[/" CHANGELOG.md | sed '1d;$d' | sed '/^$/d')
+          fi
+
+          if [ -z "$CHANGELOG" ]; then
+            CHANGELOG="Release version $VERSION"
+          fi
+
+          echo "$CHANGELOG" > changelog_excerpt.txt
+
+          echo "content<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGELOG" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts/
+
+      - name: Prepare release assets
+        run: |
+          mkdir -p release-assets
+          cd artifacts
+          for dir in */; do
+            artifact_name="${dir%/}"
+            if [ -d "$dir/bin" ]; then
+              tar -czf "../release-assets/${artifact_name}.tar.gz" -C "$dir" .
+            fi
+          done
+          cd ..
+          ls -lah release-assets/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: Release ${{ steps.version.outputs.tag }}
+          body_path: changelog_excerpt.txt
+          files: release-assets/*.tar.gz
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,3 +1,4 @@
 /target
 /tmp
 /package
+/result

CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-01-24
+### Added
+- Nix flake support for building packages
+  (support for `aarch64-linux` and `x86_64-linux` platforms)
+- GitHub workflow for building Nix packages across multiple platforms
+  (darwin not supported due to 'nixbld' user cleanup issue)
+- Add support for `overlayfs` to support read-only rootfs
+- Handle missing kernel modules gracefully in runtime
+- Add kernel config validation
+- Add arguments to specify and validate the filesystem
+  and block device for rootfs during creation
+- Support block devices using also labels
+- Add Nix definitions for u-boot and latest stable kernel
+- Add support to run qemu-system-aarch64
+- Add example minimal Nixos system to boot
+
+## [0.1.0] - 2024-07-10
+
+### Added
+- Add analyser of a current system
+
+## [0.0.9] - 2024-07-04
+
+### Added
+- Rework CLI into sub-commands
+
+## [0.0.8] - 2024-07-03
+
+### Added
+- Bugfix: Default init should be `/sbin/init`
+- Bugfix: dependencies ordering
+
+## [0.0.7] - 2024-05-13
+
+### Added
+- Implements native CPIO/zstd generator of the initramfs.zst file
+  (rather then rely on external tools to shell-out)
+
+## [0.0.6] - 2024-05-07
+
+### Added
+- Added ability to mount by disk labels
+- Fixed bugs for Debian family
+
+## [0.0.5] - 2024-05-05
+
+### Added
+- TBD by @isbm
+
+## [0.0.4] - 2024-05-02
+
+### Added
+- Mount disks by UUID
+- Initial release of microhop - Minimal initramfs /init binary
+- Initial release of microgen - Initramfs generator tool