augustohp/gitlab-cli repository overview

⁠gitlab-cli

Exposes Gitlab Ruby Gem⁠ to be used as a standalone command line application.

The version of the image reflects the Ruby version running the gem.

⁠Uses

More information on how to use this can be found on the site of the gem⁠. Below, there is some quick and useful recipes.

Display help:

$ docker run --rm --name gitlab-cli -e GITLAB_API_PRIVATE_TOKEN augustohp/gitlab-cli help

The username owner of the token:

$ docker run --rm --name gitlab-cli -e GITLAB_API_PRIVATE_TOKEN augustohp/gitlab-cli user --json --only=id,username | jq '.result.username'

List all repositories from gitlab-org organization (limited to 250 max):

$ docker run --rm --name gitlab-cli -e GITLAB_API_PRIVATE_TOKEN augustohp/gitlab-cli group_projects --json gitlab-org "{per_page: '250'}" | jq '.result[] | .path_with_namespace'

⁠Configuration

Make sure a Personal Access Token⁠ is available on GITLAB_API_PRIVATE_TOKEN environment variable:

$ export GITLAB_API_PRIVATE_TOKEN=<your access token>

You can change the Gitlab server through GITLAB_API_ENDPOINT env var:

$ export GITLAB_API_ENDPOINT="https://gitlab.com/api/v4"