diff options
author | 2017-11-08 00:15:43 +0000 | |
---|---|---|
committer | 2017-11-08 00:15:44 +0000 | |
commit | 39596fd4bb2457fa20d14ca0cdf4537122340054 (patch) | |
tree | 048edbcff4f37097c90b01b3e2e28254c09bf1f4 /docs/infra/jenkins/jjb-usage.rst | |
parent | a56fe00d0d5c962de8034b15c24b3d8310ed195e (diff) | |
parent | 346e4bbd88886a7749ec4ca19bb32be6bb1668d8 (diff) |
Merge "Updated Docs Structure"
Diffstat (limited to 'docs/infra/jenkins/jjb-usage.rst')
-rw-r--r-- | docs/infra/jenkins/jjb-usage.rst | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/docs/infra/jenkins/jjb-usage.rst b/docs/infra/jenkins/jjb-usage.rst new file mode 100644 index 000000000..2be2598d9 --- /dev/null +++ b/docs/infra/jenkins/jjb-usage.rst @@ -0,0 +1,88 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. SPDX-License-Identifier: CC-BY-4.0 +.. (c) Open Platform for NFV Project, Inc. and its contributors + +.. _jjb: + +=========================================== +Creating/Configuring/Verifying Jenkins Jobs +=========================================== + +Clone and setup the repo:: + + git clone ssh://YOU@gerrit.opnfv.org:29418/releng + cd releng + git review -s + +Make changes:: + + git commit -sv + git review + remote: Resolving deltas: 100% (3/3) + remote: Processing changes: new: 1, refs: 1, done + remote: + remote: New Changes: + remote: https://gerrit.opnfv.org/gerrit/<CHANGE_ID> + remote: + To ssh://YOU@gerrit.opnfv.org:29418/releng.git + * [new branch] HEAD -> refs/publish/master + +Test with tox:: + + tox -v -ejjb + +Submit the change to gerrit:: + + git review -v + +Follow the link given in the stdoutput to gerrit eg: +``https://gerrit.opnfv.org/gerrit/<CHANGE_ID>`` the verify job will +have completed and you will see Verified +1 jenkins-ci in the gerrit ui. + +If the changes pass the verify job +https://build.opnfv.org/ci/job/releng-verify-jjb/ , +the patch can be submitited by a committer. + +Job Types + +* Verify Job + + * Trigger: **recheck** or **reverify** + +* Merge Job + + * Trigger: **remerge** + +* Experimental Job + + * Trigger: **check-experimental** + +The verify and merge jobs are retriggerable in Gerrit by simply leaving +a comment with one of the keywords listed above. +This is useful in case you need to re-run one of those jobs in case +if build issues or something changed with the environment. + +The experimental jobs are not triggered automatically. You need to leave +a comment with the keyword list above to trigger it manually. It is useful +for trying out experimental features. + +Note that, experimental jobs `skip vote`_ for verified status, which means +it will reset the verified status to 0. If you want to keep the verified +status, use **recheck-experimental** in commit message to trigger both +verify and experimental jobs. + +You can look in the releng/INFO file for a list of current committers to +add as reviewers to your patch in order to get it reviewed and +submitted. + +Or Add the group releng-contributors + +Or just email a request for review to helpdesk@opnfv.org + +The Current merge and verify jobs for jenkins job builder can be found +in `releng-jobs.yaml`_. + +.. _releng-jobs.yaml: + https://gerrit.opnfv.org/gerrit/gitweb?p=releng.git;a=blob;f=jjb/releng-jobs.yaml; +.. _skip vote: + https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger#GerritTrigger-SkipVote |