Getting started with Gerrit Code Review for GitHub

<!DOCTYPE html> <html dir="ltr" lang="en-US"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Getting started with Gerrit Code Review for GitHub</title> <link href="css/saas-common.css" rel="stylesheet" type="text/css" media="all" /> <link href="css/saas-default.css" rel="stylesheet" type="text/css" media="all" />  <script type='text/javascript' src='js/jquery/jquery.js?ver=1.4.2'></script> <script type='text/javascript' src='js/easySlider1.5.js?ver=3.0'></script> <script type='text/javascript' src='js/saas.js?ver=3.0'></script> <script type='text/javascript' src='js/jquery.cookie.min.js?ver=3.0'></script> <script type='text/javascript' src='js/saas.twitter.js?ver=3.0'></script> </head> <body> <div class="header"> <div> <div class="center"> <div class="topLinks"> <div class="menu-top-links-container"> <ul id="menu-top-links" class="menu"> <li class="menu-item"><a href="http://gerritforge.com/contact.html" target="_blank">About</a></li> <li class="menu-item"><a href="http://gitenterprise.me/" target="_blank">Blog</a></li> <li class="menu-item current-menu-item"><a href="http://gerrithub.io/Documentation/index.html" target="_blank">Help</a></li> <li class="menu-item"><a href="http://www.gerritforge.com/contact.html" target="_blank">Contact Us</a></li> </ul> </div> </div> <h1 id="logo"><a href="http://gerrithub.io"><img src="images/logo.png" alt="GerritHub" /></a></h1> <div class="nav"> <div class="menu-main-nav-container"> </div> </div> <div class="page-title"> <div> <h2>Sign In using GitHub credentials >></h2> <div class="right"> <a href="http://review.gerrithub.io/login" class="button green"><span>Sign In</span></a> </div> </div> </div> </div> </div> </div>   <div class="container"> <div class="center"> <div class="entry"> <a href="https://review.gerrithub.io/login"> <div class="slider tall" style="float:right; margin-left: 40px; margin-top: 30px;"> <div> <ul style="width: 1260px; margin: 0 0 0 0;"> <li style="float: left; background: none; margin: 0px; padding: 0px;"> <img src="images/wizard_1.png"> </li> <li style="float: left; background: none; margin: 0px; padding: 0px;"> <img src="images/wizard_2.png"> </li> <li style="float: left; background: none; margin: 0px; padding: 0px;"> <img src="images/wizard_3.png"> </li> <li style="float: left; background: none; margin: 0px; padding: 0px;"> <img src="images/wizard_4.png"> </li> </ul> </div> </div> </a> <h3>What should I do for getting started ?</h3> <ul class="intro"> <li><strong style="color: green;"><a href="https://review.gerrithub.io/login">Sign In</a></strong> with your GitHub username and password</li> <li><strong style="color: green;">Allow GerritHub</strong> accessing your profile</li> <li>Select the <strong>SSH Public Keys</strong> you want to import</li> <li>Select the <strong style="color:blue;">Git repositories</strong> you want to use</li> </ul> <h3>Why you need to login using GitHub ?</h3> <p><strong style="color: blue;">GerritHub and GitHub work together</strong> to give you Code Review on your existing repositories: your identity on Gerrit is synchronized with your GitHub identity.</p> <h3>Why GerritHub requires write permissions ?</h3> <p>GerritHub needs a <a style="font-weight: bold; font-color: blue;" href="http://developer.github.com/v3/oauth/#scopes" target="_blank">user:email+public_repo scopes</a> when authenticating with the <a href="http://developer.github.com/v3/" target="_blank">GitHub API</a>: the only information read from your profile are <strong style="color:green;">your full name, e-mail and SSH public keys</strong>: we do NOT write any information to your GitHub profile or followers or share with any other service on-line.</p> <p>When start using GerritHub, your <strong style="color: blue">Git commits and patches for review will be mirrored back to GitHub</strong> thanks to Gerrit replication mechanism. <strong style="color: green">GerritHub pushes on your behalf your reviewed commits to your GitHub repositories.</strong></p> <p>In order to get the replication work properly, you should <strong>push to Gerrit</strong> and use your <strong>GitHub repository for pull and pull-requests only</strong>. If you keep on <strong style="color:red">pushing directly to GitHub</strong> you would cause the Gerrit <strong style="color:red">replication process to stop</strong>: this is done for avoiding to overwrite the GitHub history because of the potential conflicts.</p> <h3>How can I resume replication to GitHub ?</h3> <p>If you <strong style="color:red">pushed directly on GitHub</strong>, in order to allow <strong style="color: blue">Gerrit catching-up with the new commits on GitHub</strong> follow the steps below: <ul> <li>Clone the repository from Gerrit (git clone <i><GerritHub URL></i> master)</li> <li>Pull and merge the latest GitHub changes (git pull <i><GitHub URL></i> master)</li> <li>Push the merged branch to Gerrit (git push <i><GerritHub URL></i> master)</li> </ul> </div> </div> </div>   <div class="footer">  <div id="gerrit_footer"> <div class="links"> <div class="center"> <div> <h3>GerritHub™</h3> <p> <a href="http://gitenterprise.com/terms-of-service.html" target="_blank">Terms</a><br /> <a href="http://gitenterprise.com/privacy.html" target="_blank">Privacy</a><br /> <a href="http://gerritforge.com/support" target="_blank">Support</a><br /> </p> </div> <div> <h3>Keep in touch</h3> <ul class="social-links"> <li><a href="http://twitter.com/gitenterprise" target="_blank"><img src="images/i_socialTwitter.png" alt=""></a></li> <li><a href="http://www.facebook.com/gitenterprise" target="_blank"><img src="images/i_socialFacebook.png" alt=""></a></li> <li><a href="http://gitenterprise.me/" target="_blank"><img src="images/i_socialRss.png" alt=""></a></li> <li><a href="http://www.linkedin.com/company/3083573" target="_blank"><img src="images/i_socialLinkedin.png" alt=""></a></li> <li><a href="https://www.youtube.com/channel/UCmX-TZXPuidt3gL8F7CVjtw" target="_blank"><img src="images/i_socialYoutube.png" alt=""></a></li> </ul> </ul> </div> <div> <h3>Copyright © 2024 | GerritForge Inc.</h3> <p><a href="mailto:info@gerritforge.com">info@gerritforge.com</a><br /> <a href="http://www.gerritforge.com">www.gerritforge.com</a> </div> </div> </div> </div> </div>  <script type='text/javascript' src='js/jquery/jquery.form.js?ver=2.02m'></script> </body> </html>

CINXE.COM

Getting started with Gerrit Code Review for GitHub