gcli pipelines — Inspect and manage GitLab Pipelines
Contents
Actions
actions... may be one or more of the following:
log Dump the log of the job.
status Print a short summary of the job.
cancel Cancel the job.
retry Retry the job.
artifacts [-ooutfile]
Download the artifacts archive as a zip to disk. The default output file is artifacts.zip but
it can be overridden by using the -o flag.
Bugs
We are missing a -a flag. This is the current implied behaviour.
Please report bugs via E-Mail to ~herrhotzenplotz/gcli-discuss@lists.sr.ht.
Alternatively you can report them on any of the forges linked at https://herrhotzenplotz.de/gcli.
However, the preferred and quickest method is to use the mailing list.
gcli 2.3.0 2024-May-25 GCLI-PIPELINES(1)
Description
gcli is used to display data about the Continuous Integration (CI) service of Gitlab. You can list
pipelines of a given repository, list jobs in a given pipeline or perform actions such as restarting jobs
or fetching their logs.
Examples
Print a list of the last 30 pipelines in the current project:
$ gcli pipelines
List all jobs of pipeline #3316:
$ gcli pipelines -p3316
Dump the log of Job #423141 in herrhotzenplotz/gcli:
$ gcli pipelines -o herrhotzenplotz -r gcli -j 423141 log
Name
gcli pipelines — Inspect and manage GitLab Pipelines
Options
-o, --ownerowner
Operate on the repository of the given owner. This option can only be used in combination with
-r.
-r, --reporepo
Operate on the given repository. This option can only be used in combination with -o.
-n, --countn
Fetch at least n items. Setting n to -1 will fetch all items. Default: 30. Note that on large
repositories fetching all items can take a considerable amount of time and may result in rate
limiting by the GitLab API.
-p, --pipelinepipeline-id
List jobs in the given pipeline.
-j, --jobsjob
execute the given actions for the specified job.
See Also
git(1), gcli(1)
Synopsis
gcli [-nn] [-oowner-rrepo]
gcli-ppipeline-id [-oowner-rrepo] [-nn]
gcli-jjob-id [-oowner-rrepo] actions...