ui: add alpine local and github_alpine usage instructions #116

Merged
benvin merged 1 commits from benvin/apk-usage into master 2026-08-12 20:53:23 +10:00
Member

Why

The alpine local repo (a real apk repo with auto-generated per-arch APKINDEX) and the new github_alpine remote (metadata-only apk index synthesized from a GitHub repo's release .apk assets) shipped without any "How do I use this?" UI guidance, unlike deb/github_deb. This adds the matching client instructions so users can consume and publish to these repos.

How

  • Extend case 'alpine': in UsageInstructions.tsx to branch on isLocal (mirroring rpm/deb):
    • LOCAL: "Add the apk repo" snippet appends ${url}/api/v1/local/<name> to /etc/apk/repositories with apk update/add --allow-untrusted (served unsigned, parity with rpm gpgcheck=0), plus a "Publish a .apk" snippet uploading to the canonical <arch>/<name>-<version>.apk path (APKINDEX carries no filename, so path must match or install 404s).
    • REMOTE: existing caching-proxy snippet kept unchanged.
  • Add case 'github_alpine': (always remote-class): "Add the apk repo (metadata-only, from GitHub releases)" snippet with --allow-untrusted; note explains the per-arch APKINDEX is synthesized from release .apk assets and downloads redirect to the backing releases remote.
  • No other cases touched. npm run build (tsc typecheck + vite) passes; pre-commit passes.
## Why The alpine local repo (a real apk repo with auto-generated per-arch APKINDEX) and the new github_alpine remote (metadata-only apk index synthesized from a GitHub repo's release .apk assets) shipped without any "How do I use this?" UI guidance, unlike deb/github_deb. This adds the matching client instructions so users can consume and publish to these repos. ## How - Extend `case 'alpine':` in `UsageInstructions.tsx` to branch on `isLocal` (mirroring rpm/deb): - LOCAL: "Add the apk repo" snippet appends `${url}/api/v1/local/<name>` to `/etc/apk/repositories` with `apk update/add --allow-untrusted` (served unsigned, parity with rpm gpgcheck=0), plus a "Publish a .apk" snippet uploading to the canonical `<arch>/<name>-<version>.apk` path (APKINDEX carries no filename, so path must match or install 404s). - REMOTE: existing caching-proxy snippet kept unchanged. - Add `case 'github_alpine':` (always remote-class): "Add the apk repo (metadata-only, from GitHub releases)" snippet with `--allow-untrusted`; note explains the per-arch APKINDEX is synthesized from release .apk assets and downloads redirect to the backing releases remote. - No other cases touched. `npm run build` (tsc typecheck + vite) passes; pre-commit passes.
unkin-agent added 1 commit 2026-08-12 07:06:49 +10:00
ui: add alpine local and github_alpine usage instructions
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/pr/pre-commit Pipeline was successful
a3346618c7
benvin merged commit 0e26d99228 into master 2026-08-12 20:53:23 +10:00
benvin deleted branch benvin/apk-usage 2026-08-12 20:53:23 +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#116