Skip to content

feat(release): ship the CLI as .deb, .rpm and .apk packages - #669

Merged
bmscomp merged 1 commit into
mainfrom
feat/linux-packages
Nov 15, 2026
Merged

bmscomp merged 1 commit into
mainfrom
feat/linux-packages

Conversation

@bmscomp

@bmscomp bmscomp commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Each linux build in release.yml now packs the release binary as a .deb, .rpm and .apk with nfpm (cli/nfpm.yaml), and the GitHub Release carries them.

  • Names follow the tarballs: kates-linux-<arch>.deb, .rpm, .apk, so /releases/latest/download/kates-linux-amd64.deb always resolves. nfpm's own names put a ~ in pre-release versions.
  • Contents: kates in /usr/bin, LICENSE in /usr/share/doc/kates as a plain file, because dnf's nodocs drops files marked as docs.
  • Supply chain: the packages get build provenance (gh attestation verify kates-linux-amd64.deb --repo bmscomp/kates) and entries in checksums.txt. nfpm is pinned to v2.48.0.
  • Docs: the release notes, the README and the CLI reference's Installation section give the apt, dnf and apk commands.

Tested locally

  • Ran the new step's commands and got all three packages with their .sha256.
  • Debian 12 (amd64 .deb) and Fedora 41 (arm64 .rpm): install, kates version, remove.
  • Alpine (amd64 .apk): install with --allow-untrusted, kates version.
  • actionlint, yamllint, check-versions.sh --workflows, the book index check and check-book-style.sh pass.

Not covered

  • The attest and upload steps only run on a v* tag, so the first release is their first real run.
  • The packages are unsigned, and there is no apt or dnf repository, so apt upgrade does not see new releases.

Each linux build in release.yml now runs nfpm (cli/nfpm.yaml) on the same
binary the tarball holds, and the GitHub Release carries
kates-linux-<arch>.deb, .rpm and .apk with build provenance and entries in
checksums.txt. The names follow the tarballs, so
/releases/latest/download/kates-linux-amd64.deb always resolves and
pre-release versions never put a ~ in a file name.

The packages install kates in /usr/bin and LICENSE in
/usr/share/doc/kates, as a plain file so dnf's nodocs keeps it. The
release notes, the README and the CLI reference's Installation section
say how to install them.
@bmscomp
bmscomp merged commit 4e63e9f into main Nov 15, 2026
66 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant