upsource代码审查

upsource

从零搭建代码审查平台，需要的不仅是把代码审查的工具搭起来，还要结合公司情况制定一系列的代码审查规范。下面是对选择的upsource web端代码审查工具的安装及介绍。详细的请看这篇文档。

1.安装方法

1、下载地址 http://www.jetbrains.com/upsource/
2、如果是Linux 修改 /etc/security/limits.conf 文件，增加以下命令：
memlock unlimited
nofile 100000
nproc 32768
as unlimited
3、配置UpSource
- windows： <upsource_home>\bin\upsource.bat configure --listen-port 1111
- Linux： <upsource_home>/bin/upsource.sh configure --listen-port 1111
4、启动UpSource
- windows： <upsource_home>\bin\upsource.bat start
- Linux： <upsource_home>/bin/upsource.sh start
5、停止UpSource
- windows： <upsource_home>\bin\upsource.bat stop
- Linux： <upsource_home>/bin/upsource.sh stop
6、第一个登录的是管理员账号注册

2.启动配置

其实在公司中，基本是用Linux作为服务器的，下面的内容全都以Linux(我这里是ubuntu)为例子。

重设端口：
./upsource.sh configure --listen-port 8000

重设upsource访问ip地址：
./upsource.sh configure --base-url http://xx.xx.xx.xx:8000

3.创建 code review 工程

1.使用管理员帐户登录到Upsource（非管理员用户帐户没有资格创建新项目），点击创建一个项目。
2.General / Code intelligence / Integration / Advanced选择一种项目模板
3.以 General 项目创建为例子：
Project name: 项目名称（自行设定）
Project ID: （自动根据Project name设定，不用管）
Code review ID pattern: （一般默认）
VCS: Git / Subversion / Perforce / Mervurial
Repository URL: 源码的URL
4.Branches:
+:trunk
+:branches/*
5.Check interval:反映Upsource检查仓库中新修订的频率(默认情况下每300秒一次)。
（如果提交到您的存储库并不是经常这样做，请考虑将检查间隔设置为更大的值）
6.Users: 创建用户组:让Upsource为您创建以下用户组:
1.代码的浏览者
2.开发者
3.项目管理员
(注意或稍后自己创建它们。组是用户的集合，其中每个用户具有相同的权限或角色(权限集))
6.点击 Create Project

至此，一个code review项目创建完成。这里是写的比较简单的，详细的请看这篇文档，此文档是对官网用户手册的中文翻译，当然英语好的可以去官网查看。

4.过程遇到的问题

4.1 服务器IP地址切换后，upsource连接不上

可以通过以下命令来修改upsource的访问ip地址和port端口号

./upsource.sh configure --listen-port port --base-url http://ip:port

4.2 公司SVN服务器使用https访问，需要验证，创建不了SVN code review工程

自己测试的时候是svn://访问方式的，本以为可以了，但是用公司svn路径一测，出现这个错误：
svn: E230001: Server SSL certificate verification failed: certificate issued

出现这个原因：是因为我司svn访问方式是https方式，通过小乌龟svn客户端是可以访问的，还记得当时会弹出一个窗口询问是否接受信任认证。所以通过小乌龟访问是可以自动验证的。但是upsource是web端访问，虽然是自动带https等协议认证的，但是我不能自动安装，然后网上查找了很多，有在svn服务器那边修改的(这个肯定行不通)，有在浏览器上点击导出证书，然后一系列的shell命令配置等。以上办法都不能解决我的问题。

解决办法：其实解决办法很简单，不要忽略一个重要的前提，upsource创建svn仓库工程时是连接我们的svn库。因此可以通过先在机器本地svn checkout这个svn仓库出来，在这个过程中会询问是否接受信任认证，选择(p)ermanently 【永久接受信任】,然后输出本机 ubuntu 当前用户密码,回车, svn 用户,回车, svn 用户密码。 svn checkout 之后再去 upsource 就可以创建 svn https 的工程。

4.3 创建SVN code review工程时，+:trunk +:branches/* 填写不对造成创建失败

在创建svn code review 仓库工程时，填写Branches。乍一看，很多人会填写错误。
Use rules like +:<pattern> or -:<pattern> to include or exclude branches. Branch paths are relative to the repository URL specified above. Pattern may contain one * to match any number of characters in directory name.

这里是要求填写你的svn库是否有trunk和branch，

5.小结

此次，负责搭建公司的代码审查平台，从0到1掌握了代码审查的知识，但代码审查之路仍然还有很漫长的路要走，代码审查的习惯并非一朝一日培养好的，需要花时间来沉淀坚持。