Upsource的下载安装使用

一,下载

下载地址:

https://www.jetbrains.com/upsource/

用户手册地址

https://jetbrains.com.zh.xy2401.com/help/upsource/creating-managing-users.html

下载并解压到指定的文件夹

├── 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运行占用内存大小约6G,若命令启动停止时间过长,可通过杀死进程方式重启
查看内存占用前十的进程
 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即可完成代码评审在这里插入图片描述

create review 		创建一个代码review
attach to review    加入其他的代码review
accept changes    直接接受这个变更, 相当于直接关闭这个review

3,版本管理

在这里插入图片描述
在这里插入图片描述

4,审计分析

可以查看各个时间段,单个/所有成员,提交的代码
在这里插入图片描述可以查看各个文档,各个目录层级占用的空间大小,文件数量等
在这里插入图片描述
代码review情况
在这里插入图片描述

5,启用邮件通知

在这里插入图片描述

设置电子邮件通知

可能会希望通知Upsource用户有关Upsource中发生的不同事件,例如创建和关闭评论,分配评论者和创建新评论。
在这里插入图片描述要将Upsource配置为发送电子邮件通知,请执行以下操作:

   1,点击设置图标设定值在屏幕的右上方。“ 管理”视图将打开。

   2,点击设置电子邮件通知 。您将被重定向到SMTP设置表单。

   3,请按照说明填写表格并配置SMTP连接。

注:一般企业级邮箱使用(SMTP协议和TLS加密)
为避免混乱,Upsource会逐个汇总发生的事件,并在一条通知消息中发送事件。

每个用户还可以使用其个人“ 通知”设置来自定义要通知其事件的类型,或者完全禁用电子邮件通知。

使用户能够通过电子邮件添加评论
在这里插入图片描述

Upsource中的邮件系统不仅限于发送外发通知。配置外发电子邮件后,您可以设置专用邮箱,Upsource随后将使用该邮箱来接收传入邮件。此功能使Upsource用户无需离开电子邮件程序即可参与代码审阅讨论。

要将Upsource配置为接收电子邮件,请执行以下操作:

1,点击设置图标设定值在屏幕的右上方。“ 管理”视图将打开。
2,单击设置“通过电子邮件添加评论” 。
3,在“ 通过电子邮件添加评论”页面上,指定专用的电子邮件地址及其设置,然后选中“ 启用“通过电子邮件添加评论””复选框。
4,点击保存更改 。

猜你喜欢

转载自blog.csdn.net/xukaiqiang123/article/details/131769996
今日推荐