Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zachcheung/release-installer
A simple tool to install packages from GitHub/GitLab releases.
https://github.com/zachcheung/release-installer
cli github github-releases gitlab gitlab-releases go installer release-installer
Last synced: 12 days ago
JSON representation
A simple tool to install packages from GitHub/GitLab releases.
- Host: GitHub
- URL: https://github.com/zachcheung/release-installer
- Owner: zachcheung
- License: mit
- Created: 2024-07-12T07:11:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-11-15T02:03:49.000Z (3 months ago)
- Last Synced: 2024-11-15T02:34:01.822Z (3 months ago)
- Topics: cli, github, github-releases, gitlab, gitlab-releases, go, installer, release-installer
- Language: Go
- Homepage:
- Size: 103 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Release Installer
A simple tool to install packages from GitHub/GitLab releases or Apache HTTP server. Tested with most of the [Prometheus exporters](https://github.com/prometheus/docs/blob/c725947ff1f4aac33ea8664c9dc413ab93fd3ab4/content/docs/instrumenting/exporters.md).
## Features
* Support private repo
* Support GitLab
## Installation
* install script
```shell
curl -fsSL https://raw.githubusercontent.com/zachcheung/release-installer/main/install.sh | sh
```
* [releases](https://github.com/zachcheung/release-installer/releases)
* go install
```shell
go install github.com/zachcheung/release-installer@latest
```
## Usage
```shell
release-installer [-dir directory] [-exclude pattern] [-pattern asset_pattern] [-provider provider] [-tag tag] [-token token] [-url url]
```
It is recommended to test in a container before installing a package.
```shell
docker run --rm ghcr.io/zachcheung/release-installer -dir /tmp [OPTIONS]
```
#### Examples
* Public GitHub Repo
```console
/ # release-installer goreleaser/example
2024/07/15 01:08:46 Downloading example_1.3.0_linux_amd64.tar.gz from https://github.com/goreleaser/example/releases/download/v1.3.0/example_1.3.0_linux_amd64.tar.gz
2024/07/15 01:08:48 Downloaded example_1.3.0_linux_amd64.tar.gz
2024/07/15 01:08:48 Installed example to /usr/local/bin
```
* Private GitHub Repo
```shell
release-installer -token
```
The token should have the `repo` scope if using `Personal access tokens (classic)`.
* Public GitLab Repo
```console
/ # release-installer -provider gitlab goreleaser/example
2024/07/12 08:26:25 Downloading example_2.0.7_linux_amd64.tar.gz from https://gitlab.com/goreleaser/example/-/releases/v2.0.7/downloads/example_2.0.7_linux_amd64.tar.gz
2024/07/12 08:26:25 Downloaded example_2.0.7_linux_amd64.tar.gz
2024/07/12 08:26:25 Installed example to /usr/local/bin
```
* Private GitLab Repo (in the Self-Repo CI Job)
```shell
release-installer -provider gitlab -url $CI_SERVER_URL -token $GITLAB_TOKEN $CI_PROJECT_ID
```
The `GITLAB_TOKEN` should be set and have at least the `read_api` scope.
If the value of `-url` contains `gitlab`, the `-provider` can be omitted.
* Apache HTTP Server
```shell
release-installer -provider apache -url https://mmonit.com/monit/dist/binary/ -pattern 'linux-x64.tar.gz$' monit
```
* Exclude Specific Binaries in the Asset
```shell
release-installer -exclude '/etc/' syncthing/syncthing
```
#### Supported Providers
* GitHub
* GitLab
* Apache HTTP Server
Token is required when repo is private.
#### Supported Compressed Package
* gzip
* zip
## License
[MIT](LICENSE)