Upsource的下载安装使用

我就是我 2023-10-13 18:58 2阅读 0赞

## 一，下载 ##

### 下载地址： ###

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的正式页面了，如下：

命令行结果图  
![在这里插入图片描述][1fcd4cd438834397b86e02f17a0e20f9.png]

点击Set up进行设置，进入如下页面：  
![在这里插入图片描述][4b5bd03d1b4248fcbaef1fb5032e6421.png]

URL设置

把默认的Base URL修改掉，因为那个地址是无效的，如果需要有效需要自己去配置。  
Application Listen Port端口号可以自己修改成自己想设置的，这里使用默认的8080没有修改。之后点击下一步，进行账户设置。

### 2.账户设置 ###

点击后界面如下：  
![在这里插入图片描述][15ef178dfa8b45a09bfded939f44efbd.png]

账户设置

管理员账户用户名修改成自己想要的，然后输入密码并重复密码即可。

### 3.许可 ###

许可  
![在这里插入图片描述][8f67bc2bc4494732ae65262e16754c0d.png]

默认的是免费的许可，只能10个人使用，可以点击申请60天的10000人的许可。如果比较大型的公司或者团队，可能需要使用收费的。这里直接点击Finish完成。

### 4.等待安装完成 ###

等待安装完成  
![在这里插入图片描述][390e308cf49c40e083d759a752f8fd35.png]

这个可能会花费一点时间  
最后完成后就是如下页面：  
![在这里插入图片描述][0cd5bd57e05c40dfa5e0a91c7e4ccb48.png]  
欢迎页  
输入之前设置好的管理员账号即可进入管理页面

## 三，创建项目 ##

### 1.配置填写 ###

点击右上角登录，使用之前的管理员登录，然后点击create a project创建一个新项目如下图：  
![在这里插入图片描述][deb42a5e0a484e0097e6a7ce91ac7412.png]  
创建新项目

填写好项目名称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账号和密码  
![在这里插入图片描述][3cd194ece8dc4ba1a0e0534169fcef23.png]

## 四，添加新用户+添加项目成员 ##

### 1，添加新用户 ###

点击管理员账号名称，选择profile  
![在这里插入图片描述][918222834689412cbcbe9ad3de261ace.png]选择用户设置  
![在这里插入图片描述][d81f94e12c2947a582592e8ff3c1ce5a.png]选择分组里的所有用户  
![在这里插入图片描述][84afbf78674f4b78a3899cd2e190b5db.png]  
![在这里插入图片描述][f922391175874df1a298687568a6c8c1.png]![在这里插入图片描述][861fe2dfdf8e47f29b4c46d8a2db4a77.png]按此即可新建用户，新建的用户也可通过用户名，密码登录upsource

### 2，添加项目成员 ###

点击仪表板中的某个项目的team  
![在这里插入图片描述][f61e1eeb2d684cdeb2ab6006db7b9d06.png]  
![在这里插入图片描述][4da97d34bfc84939a4c749c69c1049e7.png]![在这里插入图片描述][c78a7ddbceb3435d948d3fb8ed513c89.png]添加项目成员完成

## 五，项目成员通过IDEA连接upsource ##

### 1，idea下载upsource插件 ###

下载后需要重启idea![在这里插入图片描述][8c1dbfe001ce4d5d9a555e861dbf8c1a.png]

### 2，idea连接upsource ###

![在这里插入图片描述][a4510372d68d4dcb849d9311e83fdf86.png]URL填的是upsource的Base URL（ip:端口号）  
**testConnection的条件是，当前项目为svn拉取的项目，且当前svn用户已添加到upsource的项目成员**

![在这里插入图片描述][8766f0483a784c4e8031fce100e0991b.png]1，连接成功后自动跳转upsource的登录页面，可登录自己upsource账号  
2，reviews面板可查看review的历史代码。弹框则是其他人提给自己的实时代码评论。  
![在这里插入图片描述][3340111f38d64ff693bc82be69abd512.png]![在这里插入图片描述][241166ea740947ec86c1336481a241ea.png]  
![在这里插入图片描述][b445061a969c45c08225560b260d088b.png]

可以选择Switch Project进行项目切换，Change User用户修改，rescan重新扫描项目review记录，open news feed打开沟通面板等操作。

## 六，upsource的其他使用 ##

### 1，代码批注及回复 ###

代码批注  
![在这里插入图片描述][674ecb0bc8b54d6180cdf56e9fc17fe7.png]登录自己账号可在右侧看到其他人给自己的批注，  
idea也可实时弹出给自己的批注，也可打开批注面板进行逐个回复，打标签等  
可以给以表情回复，文字回复，可为此批注标记标签  
![在这里插入图片描述][d46b7ccd27aa4c78bf7b39c444642ee5.png]![在这里插入图片描述][23708f80d0d54d64891756bbfa369fcd.png]  
批注提出者可以标记为已解决![在这里插入图片描述][ca3bea2f08844414a0cb3663dfa91a3a.png]

### 2，代码review流程 ###

选中要review的提交记录，点击右侧review会弹出create Review等信息，点击create Review可以进行代码评审  
![在这里插入图片描述][30d2026170f94df8a864adfbdffec50e.png]![在这里插入图片描述][f3f53a1c0e4a4da6a0ee0342bba931e3.png]  
可以对代码提交信息，评审人，作者和历史版本差异进行检查![在这里插入图片描述][2d7b0e06632b41a0875a2b34b8db631c.png]当代码存在问题之后，可以通过标注进行记录信息。如果绑定邮箱会通过邮箱通知作者  
![在这里插入图片描述][99268ca0bb384c2b875daafb5a6ada78.png]  
接收者可以通过IDEA底部的reviews模式查看代码评审记录，然后选择相关代码查看评审，批注点击右键可以进行恢复以及标注是否解决。  
![在这里插入图片描述][2002fb19634f4925b1de52fedf8fe6a5.png]![在这里插入图片描述][8be64c8c31f4405a90f2c2ca64bb6bcb.png]审查完毕点击Close即可完成代码评审![在这里插入图片描述][04dc4beb6ebe4fe790b4058a715f9fcc.png]

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

### 3，版本管理 ###

![在这里插入图片描述][df6d5935b39947808bcac951d88a2bef.png]  
![在这里插入图片描述][4c8bdf7cdaaa423ba2a039972d6f4994.png]

### 4，审计分析 ###

可以查看各个时间段，单个/所有成员，提交的代码  
![在这里插入图片描述][383481a9c6d04ff69abc0a5d3d0b1410.png]可以查看各个文档，各个目录层级占用的空间大小，文件数量等  
![在这里插入图片描述][cc025ebcb3e34951beba0421230e3b53.png]  
代码review情况  
![在这里插入图片描述][5f29fe9c1ce846c5a41f549bb5739072.png]

### 5，启用邮件通知 ###

![在这里插入图片描述][7a6e3a40f67d4b0aa345d499ab9ec266.png]

**设置电子邮件通知**

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

1，点击设置图标设定值在屏幕的右上方。“ 管理”视图将打开。
    
       2，点击设置电子邮件通知 。您将被重定向到SMTP设置表单。
    
       3，请按照说明填写表格并配置SMTP连接。

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

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

**使用户能够通过电子邮件添加评论**  
![在这里插入图片描述][f1528eca4a5a42d497a7bce5c120ca54.png]

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

**要将Upsource配置为接收电子邮件，请执行以下操作：**

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

[1fcd4cd438834397b86e02f17a0e20f9.png]: https://img-blog.csdnimg.cn/1fcd4cd438834397b86e02f17a0e20f9.png
[4b5bd03d1b4248fcbaef1fb5032e6421.png]: https://img-blog.csdnimg.cn/4b5bd03d1b4248fcbaef1fb5032e6421.png
[15ef178dfa8b45a09bfded939f44efbd.png]: https://img-blog.csdnimg.cn/15ef178dfa8b45a09bfded939f44efbd.png
[8f67bc2bc4494732ae65262e16754c0d.png]: https://img-blog.csdnimg.cn/8f67bc2bc4494732ae65262e16754c0d.png
[390e308cf49c40e083d759a752f8fd35.png]: https://img-blog.csdnimg.cn/390e308cf49c40e083d759a752f8fd35.png
[0cd5bd57e05c40dfa5e0a91c7e4ccb48.png]: https://img-blog.csdnimg.cn/0cd5bd57e05c40dfa5e0a91c7e4ccb48.png
[deb42a5e0a484e0097e6a7ce91ac7412.png]: https://img-blog.csdnimg.cn/deb42a5e0a484e0097e6a7ce91ac7412.png
[3cd194ece8dc4ba1a0e0534169fcef23.png]: https://img-blog.csdnimg.cn/3cd194ece8dc4ba1a0e0534169fcef23.png
[918222834689412cbcbe9ad3de261ace.png]: https://img-blog.csdnimg.cn/918222834689412cbcbe9ad3de261ace.png
[d81f94e12c2947a582592e8ff3c1ce5a.png]: https://img-blog.csdnimg.cn/d81f94e12c2947a582592e8ff3c1ce5a.png
[84afbf78674f4b78a3899cd2e190b5db.png]: https://img-blog.csdnimg.cn/84afbf78674f4b78a3899cd2e190b5db.png
[f922391175874df1a298687568a6c8c1.png]: https://img-blog.csdnimg.cn/f922391175874df1a298687568a6c8c1.png
[861fe2dfdf8e47f29b4c46d8a2db4a77.png]: https://img-blog.csdnimg.cn/861fe2dfdf8e47f29b4c46d8a2db4a77.png
[f61e1eeb2d684cdeb2ab6006db7b9d06.png]: https://img-blog.csdnimg.cn/f61e1eeb2d684cdeb2ab6006db7b9d06.png
[4da97d34bfc84939a4c749c69c1049e7.png]: https://img-blog.csdnimg.cn/4da97d34bfc84939a4c749c69c1049e7.png
[c78a7ddbceb3435d948d3fb8ed513c89.png]: https://img-blog.csdnimg.cn/c78a7ddbceb3435d948d3fb8ed513c89.png
[8c1dbfe001ce4d5d9a555e861dbf8c1a.png]: https://img-blog.csdnimg.cn/8c1dbfe001ce4d5d9a555e861dbf8c1a.png
[a4510372d68d4dcb849d9311e83fdf86.png]: https://img-blog.csdnimg.cn/a4510372d68d4dcb849d9311e83fdf86.png
[8766f0483a784c4e8031fce100e0991b.png]: https://img-blog.csdnimg.cn/8766f0483a784c4e8031fce100e0991b.png
[3340111f38d64ff693bc82be69abd512.png]: https://img-blog.csdnimg.cn/3340111f38d64ff693bc82be69abd512.png
[241166ea740947ec86c1336481a241ea.png]: https://img-blog.csdnimg.cn/241166ea740947ec86c1336481a241ea.png
[b445061a969c45c08225560b260d088b.png]: https://img-blog.csdnimg.cn/b445061a969c45c08225560b260d088b.png
[674ecb0bc8b54d6180cdf56e9fc17fe7.png]: https://img-blog.csdnimg.cn/674ecb0bc8b54d6180cdf56e9fc17fe7.png
[d46b7ccd27aa4c78bf7b39c444642ee5.png]: https://img-blog.csdnimg.cn/d46b7ccd27aa4c78bf7b39c444642ee5.png
[23708f80d0d54d64891756bbfa369fcd.png]: https://img-blog.csdnimg.cn/23708f80d0d54d64891756bbfa369fcd.png
[ca3bea2f08844414a0cb3663dfa91a3a.png]: https://img-blog.csdnimg.cn/ca3bea2f08844414a0cb3663dfa91a3a.png
[30d2026170f94df8a864adfbdffec50e.png]: https://img-blog.csdnimg.cn/30d2026170f94df8a864adfbdffec50e.png
[f3f53a1c0e4a4da6a0ee0342bba931e3.png]: https://img-blog.csdnimg.cn/f3f53a1c0e4a4da6a0ee0342bba931e3.png
[2d7b0e06632b41a0875a2b34b8db631c.png]: https://img-blog.csdnimg.cn/2d7b0e06632b41a0875a2b34b8db631c.png
[99268ca0bb384c2b875daafb5a6ada78.png]: https://img-blog.csdnimg.cn/99268ca0bb384c2b875daafb5a6ada78.png
[2002fb19634f4925b1de52fedf8fe6a5.png]: https://img-blog.csdnimg.cn/2002fb19634f4925b1de52fedf8fe6a5.png
[8be64c8c31f4405a90f2c2ca64bb6bcb.png]: https://img-blog.csdnimg.cn/8be64c8c31f4405a90f2c2ca64bb6bcb.png
[04dc4beb6ebe4fe790b4058a715f9fcc.png]: https://img-blog.csdnimg.cn/04dc4beb6ebe4fe790b4058a715f9fcc.png
[df6d5935b39947808bcac951d88a2bef.png]: https://img-blog.csdnimg.cn/df6d5935b39947808bcac951d88a2bef.png
[4c8bdf7cdaaa423ba2a039972d6f4994.png]: https://img-blog.csdnimg.cn/4c8bdf7cdaaa423ba2a039972d6f4994.png
[383481a9c6d04ff69abc0a5d3d0b1410.png]: https://img-blog.csdnimg.cn/383481a9c6d04ff69abc0a5d3d0b1410.png
[cc025ebcb3e34951beba0421230e3b53.png]: https://img-blog.csdnimg.cn/cc025ebcb3e34951beba0421230e3b53.png
[5f29fe9c1ce846c5a41f549bb5739072.png]: https://img-blog.csdnimg.cn/5f29fe9c1ce846c5a41f549bb5739072.png
[7a6e3a40f67d4b0aa345d499ab9ec266.png]: https://img-blog.csdnimg.cn/7a6e3a40f67d4b0aa345d499ab9ec266.png
[a5e56a7863d9488196a6384affd42de6.png]: https://img-blog.csdnimg.cn/a5e56a7863d9488196a6384affd42de6.png
[f1528eca4a5a42d497a7bce5c120ca54.png]: https://img-blog.csdnimg.cn/f1528eca4a5a42d497a7bce5c120ca54.png