docs: explain pipeline values, link style guide #1
No files matched your search
@@ -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, <server>/api/packages/<owner>/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:
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user