一,下载
下载地址:
https://www.jetbrains.com/upsource/
下载并解压到指定的文件夹
├── 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> : 显示帮助信息
注意
upsource占用内存大小约8G
查看内存占用前十的进程ps aux|head -1;ps aux|sort -rn -k4|head -10杀死进程kill -9 进程id
二,设置
1.URL设置
start执行完毕后会打开默认设置的xxx-pro.local:8080这个地址,xxx-pro.local为你服务器地址,需要配置,配置这块目前还没过多的查看,这里只做简要安装集成介绍,这里只需要知道是其实是把Upsource部署在了localhost:8080即可。因为xxx-pro.local是没有配置的,所以默认打开的地址肯定是无效的,不管它,直接手动输入localhost:8080或者把localhost改成你的ip地址(端口号别忘了写)。这样你会看到Upsource的正式页面了,如下:
命令行结果图
点击Set up进行设置,进入如下页面:
URL设置
把默认的Base URL修改掉,因为那个地址是无效的,如果需要有效需要自己去配置。
Application Listen Port端口号可以自己修改成自己想设置的,这里使用默认的8080没有修改。之后点击下一步,进行账户设置。
2.账户设置
点击后界面如下:
账户设置
管理员账户用户名修改成自己想要的,然后输入密码并重复密码即可。
3.许可
许可
默认的是免费的许可,只能10个人使用,可以点击申请60天的10000人的许可。如果比较大型的公司或者团队,可能需要使用收费的。这里直接点击Finish完成。
4.等待安装完成
等待安装完成
这个可能会花费一点时间
最后完成后就是如下页面:
欢迎页
输入之前设置好的管理员账号即可进入管理页面
三,创建项目
1.配置填写
点击右上角登录,使用之前的管理员登录,然后点击create a project创建一个新项目如下图:
创建新项目
填写好项目名称project name,下面的Porject ID和Code review ID Pattern直接用系统自动生成的即可。
�VCS版本控制工具这里我使用的是SVN,认证方式选的中间的账号密码认证。这里需要注意下Branches的填写,理论上你svn的路径下应该有trunk(主分支),Branches(其他分支)和tags(保存的历史版本),这里默认帮你填写了trunk和Branches,如果你直接管理你当前的的项目,那么这些需要删除掉,让Branches里面留空白即可,我这里svn路径下项目已经是我要管理的当前版本了(相当于trunk),所以Branches里面是都删除掉了的。最后点一下Test connection,如果成功,点击最下面的Create project完成即可。
注意:这里svn使用的是https的协议,可能会报一个错误:
svn: E200015: Server SSL certificate for 'https://xxx.x.x.xx:8443' rejected, consider testing your SSL certificate with https://www.ssllabs.com/ssltest
解决方案
这个是因为证书验证导致的
解决方法:
安装svn: yum install subversion
终端输入: svn ls https://svn版本库地址
然后输入p就行 (root后的密码也输入自己的svn密码即可)
这个命令是让忽略证书,然后按提示走就行,过程中需要输入自己的svn账号和密码
四,添加新用户+添加项目成员
1,添加新用户
点击管理员账号名称,选择profile
选择用户设置
选择分组里的所有用户
按此即可新建用户,新建的用户也可通过用户名,密码登录upsource
2,添加项目成员
点击仪表板中的某个项目的team
添加项目成员完成
五,项目成员通过IDEA连接upsource
1,idea下载upsource插件
下载后需要重启idea
2,idea连接upsource
URL填的是upsource的Base URL(ip:端口号)
testConnection的条件是,当前项目为svn拉取的项目,且当前svn用户已添加到upsource的项目成员
1,连接成功后自动跳转upsource的登录页面,可登录自己upsource账号
2,reviews面板可查看review的历史代码。弹框则是其他人提给自己的实时代码评论。
可以选择Switch Project进行项目切换,Change User用户修改,rescan重新扫描项目review记录,open news feed打开沟通面板等操作。
六,upsource的其他使用
1,代码批注及回复
代码批注
登录自己账号可在右侧看到其他人给自己的批注,
idea也可实时弹出给自己的批注,也可打开批注面板进行逐个回复,打标签等
可以给以表情回复,文字回复,可为此批注标记标签
批注提出者可以标记为已解决
2,代码review流程
选中要review的提交记录,点击右侧review会弹出create Review等信息,点击create Review可以进行代码评审
可以对代码提交信息,评审人,作者和历史版本差异进行检查当代码存在问题之后,可以通过标注进行记录信息。如果绑定邮箱会通过邮箱通知作者
接收者可以通过IDEA底部的reviews模式查看代码评审记录,然后选择相关代码查看评审,批注点击右键可以进行恢复以及标注是否解决。
审查完毕点击Close即可完成代码评审
3,版本管理
4,审计分析
可以查看各个时间段,单个/所有成员,提交的代码
可以查看各个文档,各个目录层级占用的空间大小,文件数量等
代码review情况