2. 在 Upsource 中创建一个 project 和 code review

1. 主页说明

2. 创建项目

因为绑定 github 上项目的流程项目比较简单,而自己创建一个项目则需要有自己的 SVN 货 GIT 服务,这里就只说明如何绑定 github 上项目.

点击 connect to a GitHub project,进入项目设置页面

我们使用刚刚在 Github 上创建的项目

git@github.com:felayman/Upsource-demo.git

点击 Test Connection,发现成功与该项目绑定

这里需要知道,Upsource 提供了四种不同的方式来与 github 上的项目进行访问绑定

• anonymous 匿名访问
• Passoword 用户名密码方式访问
• SHH Key 用 SSH Key 来访问
• OAuth 2.0 Token OAuth 协议访问

这里你任意选择一种,我们这里使用 SSH Key 的方式,不用输入.

连接成功后,点击 Create project 按钮,则成功连接绑定该项目

这个时候不要重启 Upsource,因为它正在从 github 上拉取代码,等待代码拉取完毕后会进行相应的配置,我们再回来主页面看下项目列表

发现项目列表中多了我们刚刚在 github 上创建的项目,我们再点击项目进入项目预览界面

界面比较简单,只能看到我在 github 上创建项目而提交的 comment 信息

这个时候,只要我们的项目有提交记录,都会出现在这个列表中,我们测试下,我们再提交一个信息到 github 上去.

其中我们新提交的信息为:

该项目为测试Upsource的例子

发现新的提交信息已经可以被看到.

3. 创建 review

我们针对某个提交进行一次 code review,将鼠标悬停在某个提交信息上,选择 create review

我们就进行 code review 的主界面,如下

然后点击 Add comment,则我们针对某个提交点进行了 code review,我们再回到项目列表

发现在创建 code review 的地方出现了一个小标记,表明该提交点有人已经创建一个可视的 review.

至此我们就简单的创建了一个 Review.

但是这并不能详细说明利用 Upsource 完整的进行 Code Review 的流程.因为都是我一个用户在进行操作,为了更好来描述如何使用 Upsource 来帮助我们完成自动化的 code review,我们创建一个用户

4. 创建用户

我们点击主页面右上角的六边形的按钮(搜索按钮右边),如下

我们点击右侧列表的 users 选项,进入创建用户的流程

点击 New User 按钮,我们创建一个用户,在创建用户的时候会有两个选项

• invite users

  邀请用户

• create user

  创建用户

这里我们选择创建一个用户,如下

创建完成之后,会进入到用户详细信息界面,如下

至此,我们新创建一个名称为 felayman 的用户,我们新打开一个浏览器,使用刚创建的账号登录

需要注意的是,第一次使用新创建的账号进行登录的时候,系统会提示你修改密码,我们修改密码之后再登录,这个时候因为该账号没有任何项目权限,如下图

我们看到我们是没有权限的,这个时候我们回到管理员登录的那个账号下,为刚才创建的名称为 felayman 的用户给予项目权限

我们打开 Upsource-demo 项目,如下,在该项目下添加用户

将我们刚刚创建的用户 felayman,添加到该项目下,这里我们不详细讲述 Upsource 中的 project-user-group-role 等之间的具体关系,我们会用专门的章节来讲述这些内容,这里只是简单教大家当前如何在某个项目下添加用户

添加完用户之后,我们再回到 felayman 登录那个浏览器的页面中刷新页面,则会出现可以访问的项目,如下

我们重新提交一些新的内容,然后对该提交点进行 code review

从该页面我们能看到该提交点的作者是 felayman,其中 reviewers 有 admin 和 felayman 两个用户,也能看到相应的用户对该提交点的评论信息

至此,一个简单的 code review 流程就完成