使用 Upsource 实现代码审查 - jetbrains 系列
镜像链接: https://juejin.im/post/5c25e2...
安装
Upsource 是什么
Upsource 作为一个代码审查工具, 有很多有益的特性.
- 执行高效的代码审查
- 从 IDE 审阅
- 通过浏览器跟踪重要的变化
- 发现设计缺陷, 找出项目中需要开发人员注意的部分
- 检测项目范围的风险, 分散责任
- 快速面板, 便于新成员了解项目并了解其他人的职责范围
- @回应, 讨论变化, 帮助队友
- 可与持续交付/问题跟踪/github同步
- 不用担心团队成员人数, 团队项目, 不限量~
下载
安装
下载并解压到指定的文件夹
目录树
├── api ├── apps ├── backups # 备份目录 ├── bin # 应用目录 ├── conf # 配置文件 ├── data ├── internal ├── launcher ├── lib ├── logs # 日志 ├── sonarqube └── temp # 临时文件
可用命令
命令的位置
$ ./bin/upsource.sh # 调用 help <command> 来查看详细
configure : 配置 Upsource start : 后台启动 run : 在当前命令行运行 status : 查看运行状态 stop : 停止 restart : 重启 rerun : 当前命令行重新运行 dump : 输出 debug info kill : 杀死 upsource 进程 java : 管理java的路径 help <command> : 显示帮助信息 help <command name> prints usage text for the specified command
详细文档查看
这里我们运行
$ ./bin/upsource.sh start Starting Upsource... * Configuring JetBrains Upsource 2018.1 * Made default base-url 'http://macbook-pro-2.local:8080/' from hostname 'macbook-pro-2.local' and listen port '8080' * JetBrains Upsource 2018.1 runtime environment is successfully configured * Loading logging configuration from /Users/duoli/Downloads/upsource-2018.1.357/lib/ext/log4j.xml * Redirecting JetBrains Upsource 2018.1 logging to /Users/duoli/Downloads/upsource-2018.1.357/logs/internal/services/bundleProcess * Configuring Service-Container[bundleProcess] * Configuring Bundle Backend Service * Configuring Configuration Wizard * Starting Service-Container[bundleProcess] * Starting Bundle Backend Service * Starting Configuration Wizard * JetBrains Upsource 2018.1 Configuration Wizard will be available on [http://macbook-pro.local:8080?wizard_token=UwxfxNH1OxGS75l3DO9p] after start Upsource is running
配置项目
根据在命令行显示的信息, 我们打开这个地址 http://macbook-pro.local:8080?wizard_token=UwxfxNH1OxGS75l3DO9p
, 如果在服务器上
这里我们点击 Set Up 来进行安装
这里来配置访问的地址, 如果是外网, 这里的地址应该是域名, 局域网替换成 IP, 如果是本地则可以替换成 localhost, 这里我替换为 localhost
创建账号密码
生成授权文件
进行安装
开始启动, 启动完成就可以登录了
在 phpstorm/jetbrains 系列中集成
这里我只是在phpstorm 中进行测试的, 但是是支持全系的, 只不过对代码部分的支持可能不太完善
配置代码审查项目
这里以 git 作为版本控制
配置基础信息
配置代码集成
其他两项的配置根据自己的喜好来进行, 这里不进行详细描述. 这样我们保存之后他就可以进行对项目初始化.
初始化完成后可以在项目中进行集成了.
安装 upsource plugin
Settings
-> 搜索 Plugin
-> Browse repositories
-> 搜索 upsource
安装并重启
关联项目
重启之后在设置中搜索 upsource
, 在 Connection
菜单中填写 Server Url
为安装完成访问的根目录. 点击 Test Connection
来进行填写账号密码授权, 授权成功后我们便可以在项目中使用了
设置完成后在右下角有个标识代表已经启动了 Upsource 服务
在这里我们可以关联项目, 切换项目, 映射路径, 配置通知, 更改用户等信息
这样我们就可以在IDE中进行代码的review 和标识了. 这里的标识和 upsource 系统中的显示的数据是实时同步的. 并且支持 @
某个人.
使用和查看
这里的这里的快捷键是 ctrl + alt + /
, 我们选中指定的行, 填写 review 代码
填写之后就会在 IDE 行号旁边和编辑区 右上角 显示评论图标, 点击即可显示需要修改的内容, 并高亮指定的区域
同样在平台上也会存在这一项目
这里有几个技巧
支持 @
来指定人
支持标签标注
好了, 团队中开始试用..
其他
错误 : 无法将数据保存到数据库
Updating project : An error occurred during flushing data to database upsource
这里内存必须在 8G 以上, 否则会报上面的错误.
错误 : 用户没有看到这个项目
一般来讲就是没有把这个用户添加到所属项目中.
参考文章
特性 : 支持自定义标签
这些标签可以同步到 IDE 中.
特性 : 多用户账户可以归到一个用户下进行管理
比如一个用户有多个git global标识, 可能是不同时期的用户的昵称, 这里可以识别为一个账户, 更方便进行管理