@PLUGIN@ save - Apply verification to one or more patch sets
ssh -p <port> <host> @PLUGIN@ save [--project <PROJECT> | -p <PROJECT>] [--branch <BRANCH> | -b <BRANCH>] [--verification <PARAMETERS> | -v <PARAMETERS>] {COMMIT | CHANGEID,PATCHSET}...
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.
--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 parameters separated by ‘|’ character.
--help -h
Display usage information.
Caller must be a member of a group that is granted the ‘Save Verification Report’ capability (provided by this plugin).
This command is intended to be used in scripts.
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.
Part of Gerrit Code Review