glr
glr
is a tool for creating GitLab Release.
Example
$ glr -upload ./dist v0.1.0
[Created release]
Title: v0.1.0
Release assets:
--> glr_v0.1.0_darwin_amd64.zip: https://gitlab.com/shiimaxx/glr-demo/uploads/.../glr_v0.1.0_darwin_amd64.zip
--> glr_v0.1.0_linux_amd64.tar.gz: https://gitlab.com/shiimaxx/glr-demo/uploads/.../glr_v0.1.0_linux_amd64.tar.gz
--> glr_v0.1.0_windows_amd64.zip: https://gitlab.com/shiimaxx/glr-demo/uploads/.../glr_v0.1.0_windows_amd64.zip
Usage
Run the glr
after you moved to the GitLab project root directory.
$ glr [options] TAG
TAG
is a git tag. You must be specified a git tag in an argument.
When including assets in the release, use -upload
option for uploading assets, or use -asset-name
and --asset-url
options for specifying any link.
GitLab Token
Please set your GitLab Token. You can get GitLab Token from this page.
$ export GITLAB_TOKEN=...
GitLab API Endpoint
Default GitLab API Endpoint is https://gitlab.com/api/v4/
. You can change it via GITLAB_API
.
export GITLAB_API=https://gitlab.example.com/api/v4/
Release assets links
GitLab Release has two type of release assets that are Souce code and Links.
glr
support creating asset links. Each link has properties that name and URL.
URL is a link to actual asset file like
- Built artifacts in GitLab CI
- External file
- Uploaded file in the project
If you want to create assets links for exists assets like build artifacts and external file, you can use -asset-name
and --asset-url
options for specifying assets URL.
Also, if you use -upload
option, can uploading local assets at the same time of creating a release and create assets links for that.
See also GitLab Docs - GitLab Release.
Install
- Download binary from release page
- Copy binary to
$PATH
directory