镜像链接:
安装
Upsource 是什么
Upsource 作为一个代码审查工具, 有很多有益的特性.
- 执行高效的代码审查
- 从 IDE 审阅
- 通过浏览器跟踪重要的变化
- 发现设计缺陷, 找出项目中需要开发人员注意的部分
- 检测项目范围的风险, 分散责任
- 快速面板, 便于新成员了解项目并了解其他人的职责范围
- @回应, 讨论变化, 帮助队友
- 可与持续交付/问题跟踪/github同步
- 不用担心团队成员人数, 团队项目, 不限量~
下载
安装
下载并解压到指定的文件夹
目录树
├── api├── apps├── backups # 备份目录├── bin # 应用目录├── conf # 配置文件├── data ├── internal├── launcher├── lib├── logs # 日志├── sonarqube└── temp # 临时文件
可用命令
命令的位置
$ ./bin/upsource.sh# 调用 help来查看详细
configure : 配置 Upsourcestart : 后台启动run : 在当前命令行运行status : 查看运行状态stop : 停止restart : 重启 rerun : 当前命令行重新运行dump : 输出 debug infokill : 杀死 upsource 进程java : 管理java的路径help: 显示帮助信息help prints usage text for the specified command
详细文档
这里我们运行
$ ./bin/upsource.sh startStarting 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 startUpsource 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标识, 可能是不同时期的用户的昵称, 这里可以识别为一个账户, 更方便进行管理
