Step: 1 Goto https://wikitech.wikimedia.org And Click on "Create Account". Now Fill ther Form. One thing You will Ask What is Instance shell account name? So Instance shell account name is required for assign you a unique name in Gerrit repo. You will understand it later. In other Word Instance shell account name is your Gerrit Username.
Step: 2 Now You will receive Successful Account Creation Message.
Step: 3 Goto https://gerrit.wikimedia.org And CLick on Sign In at upper corner. And Sign In by Username And password, Which you make on wikitech.
Step: 4 Your name show at upper corner after successfully Login.
Install Git and Git-review
Step-1:- First of all, Open the Terminal. If You are using Debian/Ubuntu Based Linux then For opening the Terminal by Ctrl + Alt + T. And then For Installing Git type
sudo apt-get install gitAnd Press the Enter.
Step-2:-Now your pc will demand the password. Enter the Operating System Password. And Hit the Enter. As you can see New message will come "Do you want to continue? [Y/n]". Pres "y" and Hit the Enter Key. The Process of installing will start.
Step-3:-After the Installation of Git. You need to Configure Git. #First, Configure Your Email By
git config --global user.email "email@example.com"#Second, Configure Your Username by
git config --global user.name "example". And Finally Type
git config -lAnd press Enter Key to confirm the things were done Succesfully.
Step-4:-Now You need to check that SSH key present on your local machine or not. For This Purpose Type
ls ~/.sshAnd Hit the Enter. If you see a file called id_rsa.pub here. the Skip Next Step Step-5, Where We Generate id_rsa.pub file.
Step-5:- To generate a new SSH key. Type
ssh-keygen -t rsa -C "firstname.lastname@example.org"And Hit the Enter. After that, We want the default settings so when asked to enter a file in which to save the key, just press enter. Then Terminal will demand "passphrases". passphrases are just like a password. It will use when You clone the Repo. So type memorable passphrase and press enter. Now Key will Successfully Generate.
Step-6:- Now, Open the https://gerrit.wikimedia.org and get the login by your Wikitech Account. Now you can see Your Name at Uppar-Right Corner. Click on that and then Setting.
Step-7:- Click on SSH Public Keys, Now the Time is to upload Your SSH key in Gerrit. For this Propose you need to go to Terminal and type
cat ~/.ssh/id_rsa.puband press the Enter. Now you can see your lengthy SSH key in your Terminal. Copy the text ssh-rsa............email@example.com and Paste Into Gerrit SSH Public Keys. And then Click on Add. Now your key has added into Gerrit.
Step-8:- Now type the
eval `ssh-agent`and press the Enter. then type
ssh-add .ssh/id_rsaand press the Enter. Now We are at this stage where We can make Connection to gerrit.wikimedia.org. For this Purpose, You need to type
ssh -p 29418 <USERNAME>@gerrit.wikimedia.orgHere <USERNAME> means your Shell Name. The Massege Are you sure you want to continue connecting (yes/no)? will Come, type yes and Press the Enter. Now you have successfully connected over SSH.
Step-8:- Now to need to Install and Setup git-review for Uploading the Patch. Just go to terminal and Type
sudo apt-get install git-reviewand press the Enter. Now your pc will demand the password. Enter the Operating System Password. And Hit the Enter. As you can see New message will come "Do you want to continue? [Y/n]". Pres "y" and Hit the Enter Key. The Process of installing will start.
Now git-review will Successfully Install.
Now this time to Config git-review. Type
git config --global gitreview.remote origin, press Enter and then type
git config --global gitreview.username <USERNAME>, Replace <USERNAME> with your Wikitech Username.
In this session, We Will learn How to upload the Patch Via Git.
Step 1 Clone the repo from Gerrit. You will find the relevant projects at https://gerrit.wikimedia.org/r/#/admin/projects/. Just find the project by typing and copy git clone command from there. Make sure you are log in.
Step 2 Update the repo by
git pull origin master, if you just clone it, then ignore it. The Repo will already be updated.
Step 3 Create and checkout the branch by
git checkout -b <BRANCH_NAME> origin/master, ussally <BRANCH_NAME> will phab task number.
Step 4 Check current branch, wherein you are working.
Step 5 Make changes in code. And see the difference by
Step 6 Check the status of repo by
git status. It will tell you which files have modified/Added/Deleted. If you satisfied with the modification just run
git add .to add all files in staging area. Or you can add them one by one through
git add <FILENAME>.
Step 7 Now time is to commit the changes. Run
Step 8 Then type the Commit messages. Make sure you write
Bug: TXXXX. Here TXXXX is the phab task number. Exit from nano editor by Ctrl+O then Ctrl + X.
Step 9 Now rebase the commit before pushing it to the Gerrit by
git pull --rebase origin master.
Step 10 Now push it into the Gerrit. Do that by
git review -R. Please make sure you have git-review package in your OS. if it is not in there. Install it by
sudo pip install git-review
Step 11 See the patch on gerrit.wikimedia.org.
You ca use https://gerrit.wikimedia.org/r/#/admin/projects/sandbox project for testing pupose.
Via Publish Edit
In this session, We Will learn How to upload the Patch Via Gerrit UI.