ui: add deb and github_deb usage instructions #113

Merged
benvin merged 1 commits from benvin/deb-usage-instructions into master 2026-08-11 23:54:34 +10:00
Member

Why

The deb and github_deb repository types had no tailored "How do I use this?" snippets in the UI — they fell through to the generic default (curl-a-file-by-path), which does not tell a user how to actually wire the repo into apt. This adds real, end-to-end-validated apt instructions mirroring how the existing package types (rpm, npm, etc.) are handled.

How

  • Adds a case 'deb': to buildSnippets that branches on isLocal: a flat real apt repo served at /api/v1/local/<name>/ ./ with [trusted=yes] plus a publish-a-.deb snippet for locals, and a caching-proxy deb <proxy> <suite> <component> form (upstream-signed, no [trusted=yes]) for remotes.
  • Adds a case 'github_deb': emitting the metadata-only flat form deb [trusted=yes] <proxy>/ ./, whose index is synthesized from a GitHub repo's release .deb assets.
  • Reuses the existing url/proxy/isLocal helpers and matches the surrounding case style; leaves the rpm and other cases untouched.
## Why The `deb` and `github_deb` repository types had no tailored "How do I use this?" snippets in the UI — they fell through to the generic default (curl-a-file-by-path), which does not tell a user how to actually wire the repo into apt. This adds real, end-to-end-validated apt instructions mirroring how the existing package types (rpm, npm, etc.) are handled. ## How - Adds a `case 'deb':` to `buildSnippets` that branches on `isLocal`: a flat real apt repo served at `/api/v1/local/<name>/ ./` with `[trusted=yes]` plus a publish-a-.deb snippet for locals, and a caching-proxy `deb <proxy> <suite> <component>` form (upstream-signed, no `[trusted=yes]`) for remotes. - Adds a `case 'github_deb':` emitting the metadata-only flat form `deb [trusted=yes] <proxy>/ ./`, whose index is synthesized from a GitHub repo's release .deb assets. - Reuses the existing `url`/`proxy`/`isLocal` helpers and matches the surrounding case style; leaves the rpm and other cases untouched.
unkin-agent added 1 commit 2026-08-11 23:38:47 +10:00
ui: add deb and github_deb usage instructions
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/pr/pre-commit Pipeline was successful
ed8d1882ef
benvin merged commit 26c37024ae into master 2026-08-11 23:54:34 +10:00
benvin deleted branch benvin/deb-usage-instructions 2026-08-11 23:54:35 +10:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: unkin/artifactapi#113