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 given in the stdoutput to gerrit eg: https://gerrit.opnfv.org/gerrit/"Your_Change_ID"
  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 look in the releng/INFO file for a list of current committers to add as reviewers to your patch in order to get it
  69 reviewed and submitted.
  70
  71 Or Add the group releng-contributors
  72
  73 Or just email a request for review to helpdesk@opnfv.org
  74
  75 The Current merge and verify jobs for jenkins job builder can be found
  76 in `releng-jobs.yaml`_.
  77
  78 .. _releng-jobs.yaml:
  79     https://gerrit.opnfv.org/gerrit/gitweb?p=releng.git;a=blob;f=jjb/releng-jobs.yaml;
  80 .. _skip vote:
  81     https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger#GerritTrigger-SkipVote