docs/jenkins-job-builder/opnfv-jjb-usage.rst

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