GLPL is a tool to display and manipulate Gitlab pipelines from your command line.
What follows is a list of steps to help you get the command line tool up and running.
-
First off you'll need a Gitlab API Token. To create one go to Gitlab: Creating A Personal Token.
Once you have your access token expose it on a environment variable name
GITLAB_PRIVATE_TOKEN
by doing:export GITLAB_PRIVATE_TOKEN="[PRIVATE_TOKEN]"
-
In order for
GLPL
to check your project's pipelines it needs to know the project's id.Look at this example to find your project ID and then export an environment variable named
GLPL_PROJECT_IDS
with the following pattern:export GLPL_PROJECT_IDS="[PROJECT1_NAME]:[PROJECT1_ID],[PROJECT2_NAME]:[PROJECT2_ID],..."
Example:
export GLPL_PROJECT_IDS="glpl:8283313,migration:4467622"
Here are the commands you need to run in order to execute multiple functions using glpl
.
-
Listing project pipelines
glpl [PROJECT_NAME]
-
Listing pipeline jobs
glpl [PROJECT_NAME] -p [PIPELINE_ID]
-
Retrying a pipeline
glpl [PROJECT_NAME] -r [PIPELINE_ID]