k3nnyandClaude Opus 5.5
e28434a030
- .github/workflows/ci.yml: same vet/staticcheck/test/build checks as Gitea CI - .github/workflows/release.yml: same five binaries and build flags as the Gitea release workflow, published with gh release create - docs: mention the GitHub mirror and both release pages; GitHub Actions example downloads from GitHub releases using RUNNER_OS/RUNNER_ARCH - docs: fix broken latest/download URL, clone URL and Go version requirement Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
67 lines
1.6 KiB
Markdown
67 lines
1.6 KiB
Markdown
---
|
|
title: Installation
|
|
weight: 10
|
|
---
|
|
|
|
## Pre-built binaries
|
|
|
|
Download the latest release for your platform from either forge — both publish identical binaries for every tag:
|
|
|
|
- [git.k3nny.fr releases](https://git.k3nny.fr/k3nny/releaser/releases) (primary)
|
|
- [GitHub releases](https://github.com/k3nnyfr/releaser/releases) (mirror)
|
|
|
|
```bash
|
|
# Linux (amd64)
|
|
curl -sSL https://git.k3nny.fr/k3nny/releaser/releases/download/v1.10.0/releaser-v1.10.0-linux-amd64 \
|
|
-o /usr/local/bin/releaser
|
|
chmod +x /usr/local/bin/releaser
|
|
|
|
# Same binary from the GitHub mirror
|
|
curl -sSL https://github.com/k3nnyfr/releaser/releases/download/v1.10.0/releaser-v1.10.0-linux-amd64 \
|
|
-o /usr/local/bin/releaser
|
|
```
|
|
|
|
Available platforms: `linux-amd64`, `linux-arm64`, `darwin-amd64`, `darwin-arm64`, `windows-amd64.exe`. Asset names embed the tag (`releaser-<tag>-<os>-<arch>`), so download URLs must name an explicit version.
|
|
|
|
## Docker
|
|
|
|
```bash
|
|
docker pull git.k3nny.fr/k3nny/releaser/releaser:latest
|
|
|
|
# Run in the current repository
|
|
docker run --rm \
|
|
-v "$PWD:/repo" \
|
|
-e GITLAB_TOKEN="$GITLAB_TOKEN" \
|
|
git.k3nny.fr/k3nny/releaser/releaser:latest
|
|
```
|
|
|
|
## Build from source
|
|
|
|
Requires the Go version declared in `go.mod` (1.26+).
|
|
|
|
```bash
|
|
git clone https://git.k3nny.fr/k3nny/releaser.git # or https://github.com/k3nnyfr/releaser.git
|
|
cd releaser
|
|
go build -o /usr/local/bin/releaser ./cmd
|
|
```
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
releaser --version
|
|
```
|
|
|
|
## First run
|
|
|
|
Scaffold a default `.releaser.yml` in your repository root:
|
|
|
|
```bash
|
|
releaser --init
|
|
```
|
|
|
|
Then do a dry run to check the version that would be produced:
|
|
|
|
```bash
|
|
releaser --dry-run
|
|
```
|