Glen is a simple command line tool that, when run within a local GitLab project, will call the GitLab API to get all environment variables from your project's CI/CD pipeline and print them locally, ready for exporting.
With the default flags you can run
eval $(glen -r) to export your project's variables
and the variables of every parent group.
The easiest way to install glen is with homebrew
brew install lingrino/tap/glen
Glen can also be installed by downloading the latest binary from the releases page and adding it to your path.
Alternatively you can install glen using
go get, assuming you have
$GOPATH/bin in your path.
go get -u github.com/lingrino/glen
By default glen assumes that you have a GitLab API key exported as
GITLAB_TOKEN and that you are
calling glen from within a git repo where the GitLab remote is named
git remote -v).
You can override all of these settings, specifying the API key, git directory, or GitLab remote name
as flags on the command line (see
By default glen will only get the variables from the current GitLab project. If you would also like
glen to merge in variables from all of the project's parent groups then you can use
Lastly, the default output for glen is called
export, meaning that the ouput is ready to be read
into your shell and will export all variables. This lets you call glen as
eval $(glen) as a one
line command to export all variables locally. You can also specify a
table output for
more machine or human friendly outputs.
$ glen --help Glen is a simple command line tool that, when run within a GitLab project, will call the GitLab API to get all environment variables from your project's CI/CD pipeline and print them locally, ready for exporting. With the default flags you can run 'eval $(glen -r)' to export your project's variables and the variables of every parent group. Usage: glen [flags] glen [command] Available Commands: help Help about any command version Returns the current glen version Flags: -k, --api-key string Your GitLab API key. NOTE - It's preferrable to specify your key as a GITLAB_TOKEN environment variable (default "GITLAB_TOKEN") -d, --directory string The directory where you're git repo lives. Defaults to your current working directory (default ".") -h, --help help for glen -o, --output string The output format. One of 'export', 'json', 'table'. Defaults to 'export', which can be executed to export all variables. (default "export") -r, --recurse Set recurse to true if you want to include the variables of the parent groups -n, --remote-name string The name of the GitLab remote in your git repo. Defaults to 'origin'. Check with 'git remote -v' (default "origin") Use "glen [command] --help" for more information about a command.
Glen does one thing (reads variables from GitLab projects) and should do that one thing well. If you notice a bug with glen plesae file an issue or submit a PR.
Also, all contributions and ideas are welcome! Please submit an issue or a PR with anything that you think could be improved.
In particular, this project could benefit from the following:
- Tests that mock git repos