clawdie/clawdie-iso
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add commit suffix to operator USB artifact names (Sam & Codex)

Browse source
This commit is contained in:
Sam & Claude 2026-05-17 10:20:34 +02:00
parent 00d06ea776
commit 4ae5c5111e
5 changed files with 34 additions and 32 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
BUILD.md
View file

@ -58,14 +58,14 @@ sudo ./build.sh
Output: Output:
```text ```text
tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY.img tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img
``` ```
Published/downloaded artifacts are compressed as `.img.gz`. Stream the Published/downloaded artifacts are compressed as `.img.gz`. Stream the
compressed image directly into `dd`: compressed image directly into `dd`:
```sh ```sh
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync
sync sync
``` ```
@ -74,15 +74,15 @@ For Linux or FreeBSD downloads from the published HTTPS path, prefer resumable
```sh ```sh
curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \ curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
curl -fL --retry 5 --retry-delay 5 -O \ curl -fL --retry 5 --retry-delay 5 -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
``` ```
For a build-local uncompressed image, plain `dd` is also fine: For a build-local uncompressed image, plain `dd` is also fine:
```sh ```sh
sudo dd if=tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY.img of=/dev/daX bs=1M status=progress conv=fsync sudo dd if=tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img of=/dev/daX bs=1M status=progress conv=fsync
sync sync
``` ```

24
FLASHING.md
View file

@ -3,7 +3,7 @@
Published Clawdie operator USB artifacts are compressed: Published Clawdie operator USB artifacts are compressed:
```text ```text
clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
``` ```
Default policy: Default policy:
@ -47,15 +47,15 @@ Download with resume and retries:
```sh ```sh
curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \ curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
curl -fL --retry 5 --retry-delay 5 -O \ curl -fL --retry 5 --retry-delay 5 -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
``` ```
Verify the downloaded artifact: Verify the downloaded artifact:
```sh ```sh
sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
``` ```
Unmount mounted USB partitions if needed: Unmount mounted USB partitions if needed:
@ -68,7 +68,7 @@ Flash by streaming gzip into `dd`:
```sh ```sh
set -o pipefail 2>/dev/null || true set -o pipefail 2>/dev/null || true
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
sync sync
``` ```
@ -97,14 +97,14 @@ curl -fL --retry 5 --retry-delay 5 -O \
Verify the downloaded artifact: Verify the downloaded artifact:
```sh ```sh
HASH=$(awk '{print $1}' clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256) HASH=$(awk '{print $1}' clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256)
sha256 -c "$HASH" clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz sha256 -c "$HASH" clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
``` ```
If `sha256sum` is installed, this GNU-style form is also OK: If `sha256sum` is installed, this GNU-style form is also OK:
```sh ```sh
sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
``` ```
Unmount mounted USB partitions if needed: Unmount mounted USB partitions if needed:
@ -116,7 +116,7 @@ sudo umount /dev/daXs* 2>/dev/null
Flash by streaming gzip into `dd`: Flash by streaming gzip into `dd`:
```sh ```sh
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync
sync sync
``` ```
@ -131,21 +131,21 @@ For a local build artifact that already exists as a raw image:
### Linux ### Linux
```sh ```sh
sudo dd if=clawdie-xfce-quindecim-usb-DD.MM.YY.img of=/dev/sdX bs=4M status=progress conv=fsync sudo dd if=clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img of=/dev/sdX bs=4M status=progress conv=fsync
sync sync
``` ```
### FreeBSD ### FreeBSD
```sh ```sh
sudo dd if=clawdie-xfce-quindecim-usb-DD.MM.YY.img of=/dev/daX bs=1M status=progress conv=fsync sudo dd if=clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img of=/dev/daX bs=1M status=progress conv=fsync
sync sync
``` ```
Only gunzip first if you specifically need the raw file for inspection or reuse: Only gunzip first if you specifically need the raw file for inspection or reuse:
```sh ```sh
gunzip -k clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz gunzip -k clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
``` ```
--- ---

17
README.md
View file

@ -108,7 +108,7 @@ Artifact names use a short Latin codename for the FreeBSD major line they were
built on. For FreeBSD `15`, that codename is `quindecim`, so: built on. For FreeBSD `15`, that codename is `quindecim`, so:
```text ```text
clawdie-xfce-quindecim-usb-DD.MM.YY.img clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img
``` ```
means: means:
@ -118,6 +118,7 @@ means:
- `quindecim` — Latin for `15`, matching the FreeBSD 15 build line - `quindecim` — Latin for `15`, matching the FreeBSD 15 build line
- `usb` — operator USB image - `usb` — operator USB image
- `DD.MM.YY` — build date - `DD.MM.YY` — build date
- `abcdef0` — short `clawdie-iso` commit used for that build
Small reference for the current naming convention: Small reference for the current naming convention:
@ -170,26 +171,26 @@ Download on Linux or FreeBSD with resume and retries:
```sh ```sh
curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \ curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
curl -fL --retry 5 --retry-delay 5 -O \ curl -fL --retry 5 --retry-delay 5 -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
``` ```
Linux: Linux:
```sh ```sh
sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
set -o pipefail 2>/dev/null || true set -o pipefail 2>/dev/null || true
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
sync sync
``` ```
FreeBSD: FreeBSD:
```sh ```sh
HASH=$(awk '{print $1}' clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256) HASH=$(awk '{print $1}' clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256)
sha256 -c "$HASH" clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz sha256 -c "$HASH" clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/daX bs=1M status=progress conv=fsync
sync sync
``` ```

12
TESTING.md
View file

@ -1,7 +1,7 @@
# Clawdie Operator USB Testing Guide # Clawdie Operator USB Testing Guide
**Branch:** `xfce-operator-usb` **Branch:** `xfce-operator-usb`
**Target artifact:** `clawdie-xfce-quindecim-usb-DD.MM.YY.img` **Target artifact:** `clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img`
**Current desktop path:** XFCE via LightDM autologin as `clawdie` **Current desktop path:** XFCE via LightDM autologin as `clawdie`
--- ---
@ -58,7 +58,7 @@ Run this on the FreeBSD build host after `build.sh` finishes.
### Useful verification commands ### Useful verification commands
```sh ```sh
sudo mdconfig -a -t vnode -f tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY.img sudo mdconfig -a -t vnode -f tmp/output/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img
sudo mount -o ro /dev/md0s2a /mnt sudo mount -o ro /dev/md0s2a /mnt
egrep 'root_rw_mount|tmpmfs|varmfs|lightdm|display_manager|clawdie_live_gpu|linux_enable|zfs_enable|kld_list' /mnt/etc/rc.conf egrep 'root_rw_mount|tmpmfs|varmfs|lightdm|display_manager|clawdie_live_gpu|linux_enable|zfs_enable|kld_list' /mnt/etc/rc.conf
@ -186,12 +186,12 @@ FreeBSD. For a published compressed image on Linux, the default path is:
```sh ```sh
curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \ curl -fL --continue-at - --retry 5 --retry-delay 5 --progress-bar -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz
curl -fL --retry 5 --retry-delay 5 -O \ curl -fL --retry 5 --retry-delay 5 -O \
https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 https://osa.smilepowered.org/downloads/iso/clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz.sha256 sha256sum -c clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz.sha256
set -o pipefail 2>/dev/null || true set -o pipefail 2>/dev/null || true
gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync gzip -dc clawdie-xfce-quindecim-usb-DD.MM.YY-abcdef0.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
sync sync
``` ```

3
build.sh
View file

@ -108,13 +108,14 @@ echo ""
# FreeBSD major release when we have one, otherwise fall back to the old # FreeBSD major release when we have one, otherwise fall back to the old
# fbsd<series> stamp. # fbsd<series> stamp.
BUILD_DATE_STAMP="$(date +%d.%m.%y)" BUILD_DATE_STAMP="$(date +%d.%m.%y)"
BUILD_REPO_SHORT_COMMIT="$(git -C "${SCRIPT_DIR}" rev-parse --short=7 HEAD 2>/dev/null || echo unknown)"
BUILD_FREEBSD_MAJOR="${FREEBSD_RELEASE_SERIES%%.*}" BUILD_FREEBSD_MAJOR="${FREEBSD_RELEASE_SERIES%%.*}"
BUILD_FREEBSD_STAMP="$(printf '%s' "${FREEBSD_RELEASE_SERIES}" | tr 'A-Z' 'a-z')" BUILD_FREEBSD_STAMP="$(printf '%s' "${FREEBSD_RELEASE_SERIES}" | tr 'A-Z' 'a-z')"
case "${BUILD_FREEBSD_MAJOR}" in case "${BUILD_FREEBSD_MAJOR}" in
15) BUILD_FREEBSD_CODENAME="quindecim" ;; 15) BUILD_FREEBSD_CODENAME="quindecim" ;;
*) BUILD_FREEBSD_CODENAME="fbsd${BUILD_FREEBSD_STAMP}" ;; *) BUILD_FREEBSD_CODENAME="fbsd${BUILD_FREEBSD_STAMP}" ;;
esac esac
IMAGE_NAME="clawdie-${DEFAULT_DESKTOP}-${BUILD_FREEBSD_CODENAME}-usb-${BUILD_DATE_STAMP}.img" IMAGE_NAME="clawdie-${DEFAULT_DESKTOP}-${BUILD_FREEBSD_CODENAME}-usb-${BUILD_DATE_STAMP}-${BUILD_REPO_SHORT_COMMIT}.img"
mkdir -p "$TMP_DIR" mkdir -p "$TMP_DIR"
: > "$NPM_CONFIG_GLOBALCONFIG" : > "$NPM_CONFIG_GLOBALCONFIG"
: > "$NPM_CONFIG_USERCONFIG" : > "$NPM_CONFIG_USERCONFIG"