Gerrit使用说明

From SylixOS-wiki
Jump to: navigation, search

Gerrit使用说明

本文介绍如何向 SylixOS 开源项目贡献源码,步骤如下:
  • 1. 获取 gerrit 用户名和密码。发送邮件给 zthsoft@zthsoft.com 提交申请,或通过其它方式联系作者获取。
  • 2. 安装 git 工具,在 windows 下执行,安装的 git 工具为 msgit。
  • 3. 打开 git bash,输入命令“ssh-keygen -t rsa”,如下:
Administrator@TECH-TIGER /D/sylixos/gitserver
$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Administrator/.ssh/id_rsa): test
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in test.
Your public key has been saved in test.pub.
The key fingerprint is:
68:1d:b8:ea:ad:06:1f:10:e3:2c:64:c2:c4:a4:01:c8 Administrator@TECH-TIGER
命令执行过程中会提示用户输入要生成的 rsa 密钥文件名,这里输入 test,命令完成后在当前目录生成 rsa 密钥对文件,包含一个公钥文件 test 和一个私钥文件 test.pub。
  • 4. 使用第一步获取的用户名和密码登录 gerrit.sylixos.com,点击页面右上角的用户名,选择 setting 和设置用户相关信息。
  • 5. 大部分设置都可以忽略,但必须添加公钥文件。选择“SSH Public Keys”选项页,使用记事本打开第3步生成的 test.pub 文件,全选并复制粘贴到“SSH Public Key”对话框,点击“Add”按钮完成公钥添加。

添加rsa公钥.png

  • 6. 将私钥文件拷贝到用户目录下的 /.ssh 目录,并更名为 id_rsa。
  • 7. 检出工程。登录 gerrit.sylixos.com,点击 Project->List 列出所有工程,打开需要检出的工程。这里选择的 demo 工程,选择“clone with commit-msg hook”选项卡,复制 git 命令。如下图:

Gerrit检出.png

  • 8. 在 git bash 中粘贴复制的 git 命令,回车完成检出。
  • 9. 提交修改,首先使用“git commit”命令 commit 更改到本地,然后使用“git push origin master:refs/for/master”命令将 push 更改到远程的 refs/for/master 分支,这是 gerrit 的要求,不能直接 push 到 master 分支。
  • 10. push 完成后登录 gerrit.sylixos.com,会在 My->Changes 页面下看到本次 push 请求,处于等待代码 review 状态,当代码 review 通过后,代码提交人可在 gerrit 页面中将更改提交到 master 分支。
(注:关于gerrit 的原理和更为详细的使用方法,可在网上搜索得到,下面列出一些参考网页)
gerrit原理简介
gerrit使用简介
Personal tools
Namespaces

Variants
Actions
Navigation
Tools