diff --git a/.gitea/workflows/os.yml b/.gitea/workflows/os.yml index 9b8cba5..c471b99 100644 --- a/.gitea/workflows/os.yml +++ b/.gitea/workflows/os.yml @@ -3,6 +3,28 @@ # Builds the OS image and publishes it as version "latest". VMs fetch the build # images as updates (mkosi.extra/usr/lib/sysupdate.d). Runs on every push, # weekly for package updates, and by hand for critical CVE's. +# +# Values used below: +# - PKG upload location, /api/packages//generic/ +# agent/latest. Path= in mkosi.extra/usr/lib/sysupdate.d/ +# *.transfer points at the same place. +# - AUTH the job's automatic token (gitea.token), which can write +# the owner's packages. +# - SECUREBOOT_KEY repository secret: the private key of mkosi.crt, written +# to mkosi.key. +# - SIGNING_KEY repository secret: the armored private gpg key whose +# public half is mkosi.extra/usr/lib/systemd/ +# import-pubring.pgp, which systemd-sysupdate checks. +# - zstd -19 -T0 the root and verity partitions have a fixed size (1 GiB, +# 64 MiB) and are mostly zero padding: zstd shrinks them +# from ~1.1 GB to ~245 MB. -19 is ~11% smaller than the +# default -3, for ~35 s more build time. -T0 uses all +# cores; --rm deletes the .raw files. systemd-sysupdate +# decompresses .raw.zst as it downloads. +# - qemu-img -c agent.qcow2, the whole disk compressed, for creating new +# VMs (not for updates). +# - SHA256SUMS checksums of the update files, signed as SHA256SUMS.gpg +# (Verify=yes in sysupdate.d). name: os on: push: diff --git a/README.md b/README.md index 2aed6eb..c268093 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ As soon as Claude is logged in, `claude-remote.service` starts `claude remote-co ## Development -`mkosi.conf` defines the OS (`mkosi.extra/` is copied to `/`, `mkosi.repart/` is the disk layout, `mkosi.sandbox/` adds the Claude Code package repository). +`mkosi.conf` defines the OS (`mkosi.extra/` is copied to `/`, `mkosi.repart/` is the disk layout, `mkosi.sandbox/` adds the Claude Code package repository). When changing files, follow [STYLE.md](STYLE.md). ```sh mkosi build diff --git a/STYLE.md b/STYLE.md index eee2d81..01f4864 100644 --- a/STYLE.md +++ b/STYLE.md @@ -16,8 +16,7 @@ Every file that allows comments starts with a header. It goes after the shebang, #!/bin/sh # Image version # -# Prints the build time in UTC (YYYYMMDDhhmm). Every build gets a higher version than the one -# before, which is how systemd-sysupdate tells that an update is newer. +# The build time (UTC), so every build is newer than the last. ``` - Line 1 is a title: a few words, in sentence case, with no full stop.