52dbdebe5738793c380a510d8cde53f0c419f42d
[releng.git] / 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 Follow the link to gerrit https://gerrit.opnfv.org/gerrit/51 in a few moments
25 the verify job will have completed and you will see Verified +1 jenkins-ci in
26 the gerrit ui.
27
28 If the changes pass the verify job
29 https://build.opnfv.org/ci/view/builder/job/builder-verify-jjb/ ,
30 the patch can be submitited by a committer.
31
32 Job Types
33
34 * Verify Job
35
36   * Trigger: **recheck** or **reverify**
37
38 * Merge Job
39
40   * Trigger: **remerge**
41
42 * Experimental Job
43
44   * Trigger: **check-experimental**
45
46 The verify and merge jobs are retriggerable in Gerrit by simply leaving
47 a comment with one of the keywords listed above.
48 This is useful in case you need to re-run one of those jobs in case
49 if build issues or something changed with the environment.
50
51 The experimental jobs are not triggered automatically. You need to leave
52 a comment with the keyword list above to trigger it manually. It is useful
53 for trying out experimental features.
54
55 Note that, experimental jobs `skip vote`_ for verified status, which means
56 it will reset the verified status to 0. If you want to keep the verified
57 status, use **recheck-experimental** in commit message to trigger both
58 verify and experimental jobs.
59
60 You can add below persons as reviewers to your patch in order to get it
61 reviewed and submitted.
62
63 * fatih.degirmenci@ericsson.com
64 * agardner@linuxfoundation.org
65 * trozet@redhat.com
66 * morgan.richomme@orange.com
67 * vlaza@cloudbasesolutions.com
68 * matthew.lijun@huawei.com
69 * meimei@huawei.com
70 * jose.lausuch@ericsson.com
71 * koffirodrigue@gmail.com
72 * r-mibu@cq.jp.nec.com
73 * tbramwell@linuxfoundation.org
74
75 Or Add the group releng-contributors
76
77 Or just email a request for submission to opnfv-helpdesk@rt.linuxfoundation.org
78
79 The Current merge and verify jobs for jenkins job builder can be found
80 in `releng-jobs.yaml`_.
81
82 .. _releng-jobs.yaml:
83     https://gerrit.opnfv.org/gerrit/gitweb?p=releng.git;a=blob;f=jjb/releng-jobs.yaml;
84 .. _skip vote:
85     https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger#GerritTrigger-SkipVote