FeCru基本操作

àì夳堔傛蜴生んèń 2021-11-11 04:56 316阅读 0赞

> 一直困扰于产品代码随着时间的流逝日趋腐朽，组员提交的代码质量无法进行有效审查，代码审核无法形成正反馈，同样的解决方案需要一遍遍地重复，同样的问题要一次次地强调。最终于最近决定引入代码审核平台。

### 1. 概述 ###

传统业务公司，软件研发部的第一要义是对业务的支撑和及时响应，对于技术的要求并不高，相应得对人员的要求也就没那么严苛了。此种情况下相应功能的实现代码质量实在让各个小组组长揪心，因此构建一个统一的代码审核平台，引入代码审核环节，确保入库代码质量，同时将代码审核成果固化，进而反向引导研发人员水平的提升，形成正向循环势必成为一个很有诱惑力的决策。

### 2. 关于FeCru ###

Atlassian提供的系列产品中进行代码评审的是Crucible，而对应的代码管理是Fisheye，Atlassian公司将这两个工具合并成为FeCru。

1.  FishEye能够为你打开代码库，并帮助你分析代码，将充分了解你的源代码信息。是一款源代码深度查看工具，主要用来做代码审查。源代码库中有非常多的有用信息，这些信息不容易提取，或及时跟踪，FishEye可以帮助我们更快更便捷的了解我们的变更代码。保证我们的项目更加有质量，提早发现问题。Fisheye可以与Git、SVN等代码版本管理工具集成，需要一个可读权限的账户即可。
2.  Crucible是一个用于开发团队的代码检测工具，有了Crucible团队成员可以检查、注释、编辑代码，并记录结果。当发现一个潜在的代码问题，你可以挑选出这条代码行并做注释。使用Crucible有规律的作代码检查，可以帮助开发人员发现和纠正缺陷，提高代码开发的效率。

### 3. 关于安装 ###

Atlassian的系列产品都有着安装简单化的优势，FeCru也不例外。不过需要注意的是：

1.  对于FeCru在Windows下的安装，最后一步Extra File会需要相当长的时候（一小时+），笔者初次安装时候，在等待了近十分钟后以为程序假死了…。
2.  Fisheye默认是不支持MySQL的，你需要自己将MySQL驱动添加到程序包的lib/下。
3.  其他的安装细节，网上已经有了详尽的教程，读者可以参见底部的链接，本文的重心也是安装之后的基本操作。

### 4. 以管理员登录 ###

因为Fisheye在安装成功后，默认是没有任何账户的，你需要进入管理界面来添加系统用户。但这一步操作不看教程，读者是肯定想不到的。不卖关子了，直接看下图，你得通过点击这个位置（首页底部的Administration链接）才能达到管理员登录界面。注意**登录界面只需要输入在安装时候配置的密码**即可，无需用户名。  
![管理界面入口 - 首页底部的Administration链接][- _Administration]

### 5. 添加用户 ###

在进入管理界面后，我们就需要给相应人员分配账户，以管理权限，以及保留各用户各自的操作结果（比如代码审核意见等）。

以下是超级管理员权限下，与用户操作相关的选项。  
![用户相关操作][20190804134234404.png]  
添加用户的时候，最好确保邮箱地址的可用性，这样以后当所关注的版本库出现变动的时候，能够第一时间得到通知。![添加用户][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70]

### 6. 添加仓库 ###

以下是超级管理员权限下，与仓库操作相关的选项。  
![仓库相关操作][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 1]  
添加仓库的时候，一共分为三小步，其中需要特别注意的是正是第二步：

1.  第一步是选择版本库类型，以及输入相应的辨识度高的名称。这里注意——Display Name不能包含中文。  
    ![选择版本库][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 2]
2.  关于容易出错的第二步，点击"Test Connection"如果出现如下内容，则是代表配置有问题，千万不要以为看到"Connection successed"就以为万事大吉了。必须**只显示绿色字体的"Connection successed"才代表配置正确**。  
    这里经常容易犯的错就是将将SVN地址全部写在了URL处，这是不合适的。**添加仓库的时候还是需要把路径分开**。  
    ![测试链接][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 3]  
    正确的配置示例（SVN URL和Path分开配置）：  
    ![url和path分开配置][url_path]
3.  保持默认选项，直接点击添加即可。

### 7. 其他可能的问题 ###

1.  当仓库配置完毕，我们查看其状态时候，可能出现以下问题：  
    ![报错][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 4]  
    对于这个错误，其实就是上面添加仓库时候第二步时候的连锁反应。解决方案也很简单——直接**重建索引**即可。方法如下：  
    ![重建索引][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 5]

### 8. Links ###

1.  [Atlassian系列之fisheye4.7安装][Atlassian_fisheye4.7]
2.  [ fisheye4.7 添加仓库时的相关问题][fisheye4.7]

[- _Administration]: /images/20211109/b41c430f95434b909d9e015467ba4820.png
[20190804134234404.png]: /images/20211109/f94d65d4c3b04d979c896129642ad022.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70]: /images/20211109/5d6ab876c3564fbd8cabf1772065f95f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 1]: /images/20211109/3eb85cd43ca4490fa6d3d05ee7409df6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 2]: /images/20211109/c546f5b57e844bc5967c5d927dcdfb61.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 3]: /images/20211109/f0b6f4036d7843fe966479b47c932104.png
[url_path]: /images/20211109/b36adbe8c21342d9bcf08fb41c5d5233.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 4]: /images/20211109/9f734fc9f1f949e8bd1ad93310a3551f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xxemtjeDM_size_16_color_FFFFFF_t_70 5]: /images/20211109/e78bf7dda170421f9914e3daebc20d30.png
[Atlassian_fisheye4.7]: https://www.jianshu.com/p/f9029b2cbaf7
[fisheye4.7]: https://www.jianshu.com/p/f56601b6d61f