Man page - gcli-pipelines(1)
Packages contains this manual
Manual
GCLI-PIPELINES (1) General Commands Manual GCLI-PIPELINES (1)
NAME
gcli pipelines — Inspect and manage GitLab Pipelines
SYNOPSIS
gcli
[
-n
n
]
[
-o
owner
-r
repo
]
gcli -p
pipeline-id
[
-o
owner
-r
repo
]
[
-n
n
]
gcli -j
job-id
[
-o
owner
-r
repo
]
actions...
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.
OPTIONS
-o
,
--owner
owner
Operate on the repository of the given owner. This option can only be used in combination with -r .
-r , --repo repo
Operate on the given repository. This option can only be used in combination with -o .
-n , --count n
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 , --pipeline pipeline-id
List jobs in the given pipeline.
-j , --jobs job
execute the given actions for the specified job .
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 [ -o outfile ]
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.
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
SEE ALSO
git (1), gcli (1)
AUTHORS
Nico Sonack aka. herrhotzenplotz < nsonack@herrhotzenplotz.de > and contributors.
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)