| @PLUGIN@ save |
| ============= |
| |
| NAME |
| ---- |
| @PLUGIN@ save - Apply verification to one or more patch sets |
| |
| SYNOPSIS |
| -------- |
| > ssh -p <port> <host> @PLUGIN@ save |
| > [--project <PROJECT> | -p <PROJECT>] |
| > [--branch <BRANCH> | -b <BRANCH>] |
| > [--verification <PARAMETERS> | -v <PARAMETERS>] |
| > {COMMIT | CHANGEID,PATCHSET}... |
| |
| |
| DESCRIPTION |
| ----------- |
| Updates a specified patchset or commit with a verification, |
| sending out email notifications and updating the database. |
| |
| To report the outcome for multiple jobs at once, the verification |
| parameter can be used multiple times. |
| |
| Patch sets may be specified in 'CHANGEID,PATCHSET' format, such as |
| '8242,2', or 'COMMIT' format. |
| |
| If a patch set is specified with the 'COMMIT' format, the complete |
| or abbreviated commit SHA-1 may be used. If the same commit is available |
| in multiple projects the `--project` option may be used to limit where |
| Gerrit searches for the change to only the contents of the specified project. |
| If the same commit is available in multiple branches the `--branch` option |
| may be used to limit where Gerrit searches for changes to only the specified |
| branch. |
| |
| |
| OPTIONS |
| ------- |
| |
| --project |
| -p |
| > Name of the project the intended changes are contained |
| > within. This option must be supplied before the commit |
| > SHA-1 in order to take effect. |
| |
| --branch |
| -b |
| > Name of the branch the intended changes are contained |
| > within. This option must be supplied before the commit |
| > SHA-1 in order to take effect. |
| |
| --verification |
| -v |
| > The key=value pair of [VerifyInput](rest-api-changes.md#verify-input) |
| > parameters separated by '|' character. |
| |
| --help |
| -h |
| > Display usage information. |
| |
| |
| ACCESS |
| ------ |
| Caller must be a member of a group that is granted the |
| 'Save Verification Report' capability (provided by this plugin). |
| |
| SCRIPTING |
| --------- |
| This command is intended to be used in scripts. |
| |
| EXAMPLES |
| -------- |
| |
| Report results for 'gate-horizon-pep8' job with score=+1 on the patchset with |
| commit 14a95001c. Results can be updated by posting with the same job name. |
| |
| > $ ssh -p 29418 review.example.com @PLUGIN@ save --verification |
| > "'name=gate-horizon-pep8 |
| > |value=1 |
| > |url=https://ci.host.com/jobs/pep8/4711 |
| > |reporter=Jenkins CI Check |
| > |category=slow |
| > |duration=1m 30s'" |
| > 14a95001c |
| |
| |
| Report multiple job results |
| |
| > $ ssh -p 29418 review.example.com @PLUGIN@ save |
| > --verification |
| > "'name=gate-horizon-pep8 |
| > |value=1 |
| > |url=https://ci.host.com/jobs/pep8/4711 |
| > |reporter=Jenkins CI Check |
| > |duration=1m 30s'" |
| > --verification |
| > "'name=gate-python-27 |
| > |value=-1 |
| > |url=https://ci.host.com/jobs/python-27/8312 |
| > |reporter=Jenkins CI Check |
| > |duration=2m 10s'" |
| > 14a95001c |
| |
| *__Notice__ two levels of quoting are required, one for the local shell, and |
| another for the argument parser inside the Gerrit server. |
| |
| SEE ALSO |
| -------- |
| |
| * [Access Controls](../../../Documentation/access-control.html) |
| * [Command Line Tools](../../../Documentation/cmd-index.html) |
| |
| GERRIT |
| ------ |
| Part of [Gerrit Code Review](../../Documentation/index.html) |
