Add Gerrit Guide
[docs.git] / docs / gerrit.rst
1 ############
2 Gerrit Guide
3 ############
4
5 How to push to Gerrit
6 =====================
7
8 It is highly recommended to use ssh to push to Gerrit to push code to Gerrit.
9 In the event that you cannot use ssh such as corporate firewall blocking you
10 then falling back to pushing via https should work.
11
12 Using ssh to push to Gerrit
13 ---------------------------
14
15 # TODO
16
17 Using https to push to Gerrit
18 -----------------------------
19
20 Gerrit does not allow you to use your regular account credentials when pushing
21 via https. Instead it requires you to first generate a http password via the
22 webui and use that as the password when pushing via ssh.
23
24 To do this navigate to https://git.opendaylight.org/gerrit/#/settings/http-password
25 and click the **Generate Password** button. Gerrit will then generate a random
26 password which you will need to use as your password when using git to push
27 code to Gerrit.