一直困扰于产品代码随着时间的流逝日趋腐朽,组员提交的代码质量无法进行有效审查,代码审核无法形成正反馈,同样的解决方案需要一遍遍地重复,同样的问题要一次次地强调。最终于最近决定引入代码审核平台。
1. 概述
传统业务公司,软件研发部的第一要义是对业务的支撑和及时响应,对于技术的要求并不高,相应得对人员的要求也就没那么严苛了。此种情况下相应功能的实现代码质量实在让各个小组组长揪心,因此构建一个统一的代码审核平台,引入代码审核环节,确保入库代码质量,同时将代码审核成果固化,进而反向引导研发人员水平的提升,形成正向循环势必成为一个很有诱惑力的决策。
2. 关于FeCru
Atlassian提供的系列产品中进行代码评审的是Crucible,而对应的代码管理是Fisheye,Atlassian公司将这两个工具合并成为FeCru。
- FishEye能够为你打开代码库,并帮助你分析代码,将充分了解你的源代码信息。是一款源代码深度查看工具,主要用来做代码审查。源代码库中有非常多的有用信息,这些信息不容易提取,或及时跟踪,FishEye可以帮助我们更快更便捷的了解我们的变更代码。保证我们的项目更加有质量,提早发现问题。Fisheye可以与Git、SVN等代码版本管理工具集成,需要一个可读权限的账户即可。
- Crucible是一个用于开发团队的代码检测工具,有了Crucible团队成员可以检查、注释、编辑代码,并记录结果。当发现一个潜在的代码问题,你可以挑选出这条代码行并做注释。使用Crucible有规律的作代码检查,可以帮助开发人员发现和纠正缺陷,提高代码开发的效率。
3. 关于安装
Atlassian的系列产品都有着安装简单化的优势,FeCru也不例外。不过需要注意的是:
- 对于FeCru在Windows下的安装,最后一步Extra File会需要相当长的时候(一小时+),笔者初次安装时候,在等待了近十分钟后以为程序假死了…。
- Fisheye默认是不支持MySQL的,你需要自己将MySQL驱动添加到程序包的lib/下。
- 其他的安装细节,网上已经有了详尽的教程,读者可以参见底部的链接,本文的重心也是安装之后的基本操作。
4. 以管理员登录
因为Fisheye在安装成功后,默认是没有任何账户的,你需要进入管理界面来添加系统用户。但这一步操作不看教程,读者是肯定想不到的。不卖关子了,直接看下图,你得通过点击这个位置(首页底部的Administration链接)才能达到管理员登录界面。注意登录界面只需要输入在安装时候配置的密码即可,无需用户名。
5. 添加用户
在进入管理界面后,我们就需要给相应人员分配账户,以管理权限,以及保留各用户各自的操作结果(比如代码审核意见等)。
以下是超级管理员权限下,与用户操作相关的选项。
添加用户的时候,最好确保邮箱地址的可用性,这样以后当所关注的版本库出现变动的时候,能够第一时间得到通知。
6. 添加仓库
以下是超级管理员权限下,与仓库操作相关的选项。
添加仓库的时候,一共分为三小步,其中需要特别注意的是正是第二步:
- 第一步是选择版本库类型,以及输入相应的辨识度高的名称。这里注意——Display Name不能包含中文。
- 关于容易出错的第二步,点击"Test Connection"如果出现如下内容,则是代表配置有问题,千万不要以为看到"Connection successed"就以为万事大吉了。必须只显示绿色字体的"Connection successed"才代表配置正确。
这里经常容易犯的错就是将将SVN地址全部写在了URL处,这是不合适的。添加仓库的时候还是需要把路径分开。
正确的配置示例(SVN URL和Path分开配置):
- 保持默认选项,直接点击添加即可。
7. 其他可能的问题
- 当仓库配置完毕,我们查看其状态时候,可能出现以下问题:
对于这个错误,其实就是上面添加仓库时候第二步时候的连锁反应。解决方案也很简单——直接重建索引即可。方法如下: