docs/infra/jenkins/jjb-usage.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. SPDX-License-Identifier: CC-BY-4.0
   3 .. (c) Open Platform for NFV Project, Inc. and its contributors
   4
   5 .. _jjb:
   6
   7 ===========================================
   8 Creating/Configuring/Verifying Jenkins Jobs
   9 ===========================================
  10
  11 Clone and setup the repo::
  12
  13     git clone ssh://YOU@gerrit.opnfv.org:29418/releng
  14     cd releng
  15     git review -s
  16
  17 Make changes::
  18
  19     git commit -sv
  20     git review
  21     remote: Resolving deltas: 100% (3/3)
  22     remote: Processing changes: new: 1, refs: 1, done
  23     remote:
  24     remote: New Changes:
  25     remote:   https://gerrit.opnfv.org/gerrit/<CHANGE_ID>
  26     remote:
  27     To ssh://YOU@gerrit.opnfv.org:29418/releng.git
  28      * [new branch]      HEAD -> refs/publish/master
  29
  30 Test with tox::
  31
  32     tox -v -ejjb
  33
  34 Submit the change to gerrit::
  35
  36     git review -v
  37
  38 Follow the link given in the stdoutput to gerrit eg:
  39 ``https://gerrit.opnfv.org/gerrit/<CHANGE_ID>`` the verify job will
  40 have completed and you will see Verified +1 jenkins-ci in the gerrit ui.
  41
  42 If the changes pass the verify job
  43 https://build.opnfv.org/ci/job/releng-verify-jjb/ ,
  44 the patch can be submitited by a committer.
  45
  46 Job Types
  47
  48 * Verify Job
  49
  50   * Trigger: **recheck** or **reverify**
  51
  52 * Merge Job
  53
  54   * Trigger: **remerge**
  55
  56 * Experimental Job
  57
  58   * Trigger: **check-experimental**
  59
  60 The verify and merge jobs are retriggerable in Gerrit by simply leaving
  61 a comment with one of the keywords listed above.
  62 This is useful in case you need to re-run one of those jobs in case
  63 if build issues or something changed with the environment.
  64
  65 The experimental jobs are not triggered automatically. You need to leave
  66 a comment with the keyword list above to trigger it manually. It is useful
  67 for trying out experimental features.
  68
  69 Note that, experimental jobs `skip vote`_ for verified status, which means
  70 it will reset the verified status to 0. If you want to keep the verified
  71 status, use **recheck-experimental** in commit message to trigger both
  72 verify and experimental jobs.
  73
  74 You can look in the releng/INFO file for a list of current committers to
  75 add as reviewers to your patch in order to get it reviewed and
  76 submitted.
  77
  78 Or Add the group releng-contributors
  79
  80 Or just email a request for review to helpdesk@opnfv.org
  81
  82 The Current merge and verify jobs for jenkins job builder can be found
  83 in `releng-jobs.yaml`_.
  84
  85 .. _releng-jobs.yaml:
  86     https://gerrit.opnfv.org/gerrit/gitweb?p=releng.git;a=blob;f=jjb/releng-jobs.yaml;
  87 .. _skip vote:
  88     https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger#GerritTrigger-SkipVote