From ae5ee229a976437fb59095603031d27cb9d3f570 Mon Sep 17 00:00:00 2001 From: Xenolphthalein <21215869+Xenolphthalein@users.noreply.github.com> Date: Sat, 14 Nov 2026 22:01:32 +0100 Subject: [PATCH] docs: the image's Ubuntu packages: their licenses, each package's source package and version in the lists, and where every source version is kept --- .github/workflows/image.yml | 2 ++ README.md | 8 +++++++- image/Dockerfile | 3 ++- tests/test_image.py | 1 + 4 files changed, 12 insertions(+), 2 deletions(-) diff --git a/.github/workflows/image.yml b/.github/workflows/image.yml index d20128e..d1c198f 100644 --- a/.github/workflows/image.yml +++ b/.github/workflows/image.yml @@ -142,6 +142,8 @@ jobs: echo '```' echo echo "Built from image/ as of ${GITHUB_SHA}, tested and published as it was built; the packages of each variant are attached." + echo + echo "The image holds Ubuntu 24.04's packages under their own licenses; each line of the package lists names a package, its version, architecture, source package and source version, whose sources are at https://launchpad.net/ubuntu/+source/SOURCE/VERSION (README, License)." } > notes.md gh release create "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" --verify-tag \ --title "$GITHUB_REF_NAME" --notes-file notes.md packages-amd64.txt packages-arm64.txt diff --git a/README.md b/README.md index f3b25e7..257a3c5 100644 --- a/README.md +++ b/README.md @@ -66,4 +66,10 @@ docker build -t builder:local image ## License -[The Unlicense](LICENSE). The image itself contains Ubuntu's packages under their own licenses. +[The Unlicense](LICENSE): the Dockerfile and the scripts. The image itself contains Ubuntu 24.04's packages, +unmodified, each under its own licenses (many GPL or LGPL), stated in the image's +`/usr/share/doc/PACKAGE/copyright`. Their sources are Ubuntu's: each release's `packages-ARCH.txt` (in the +image `/usr/share/overpressure-packages.txt`) lists every package with its version and its source package and +version, and every published version of a source package, with its `.dsc`, upstream and Debian archives, is +kept at `https://launchpad.net/ubuntu/+source/SOURCE/VERSION` (also by date on snapshot.ubuntu.com). The +image is a build tool for developers and CI; nothing of it goes onto a headset. diff --git a/image/Dockerfile b/image/Dockerfile index fb4d2f8..cc45194 100644 --- a/image/Dockerfile +++ b/image/Dockerfile @@ -22,7 +22,8 @@ RUN set -eu; \ make gcc libc6-dev $cross flex bison bc git perl cpio libssl-dev libelf-dev dwarves device-tree-compiler \ shellcheck; \ rm -rf /var/lib/apt/lists/*; \ - dpkg-query -W -f '${Package} ${Version} ${Architecture}\n' | sort > /usr/share/overpressure-packages.txt; \ + dpkg-query -W -f '${Package} ${Version} ${Architecture} ${source:Package} ${source:Version}\n' | sort \ + > /usr/share/overpressure-packages.txt; \ git config --system --add safe.directory '*' # the checkout (/work, a worktree's /git) is the host user's, git here runs as root COPY entrypoint.sh /usr/local/bin/overpressure-entrypoint COPY binfmt.sh /usr/local/bin/overpressure-binfmt diff --git a/tests/test_image.py b/tests/test_image.py index ffa3656..a825a9b 100644 --- a/tests/test_image.py +++ b/tests/test_image.py @@ -133,6 +133,7 @@ def test_the_image_has_every_script_the_entrypoint_runs(self): # The base pinned by digest; the packages are what the published image holds. self.assertRegex(dockerfile, r"FROM ubuntu:24\.04@sha256:[0-9a-f]{64}") self.assertIn("/usr/share/overpressure-packages.txt", dockerfile) + self.assertIn("${source:Package} ${source:Version}", dockerfile) # each package's source (README) for package in ("clang-20", "lld-20", "qemu-user-static", "e2fsprogs", "device-tree-compiler"): self.assertIn(package, dockerfile)