当前位置：首页 > news >正文

Arbess从基础到实践(22) - 集成GitPuk+sourcefare+PostIn自动化部署

news 2026/5/26 14:55:58

Arbess作为一款国产开源免费的CI/CD 工具，工具安装部署更轻量，使用更简洁。本文将详细介绍如何安装配置使用Arbess+GitPuk+sourcefare+PostIn实现代码提交触发代码扫描/构建/部署/接口自动化测试

1、GitPuk 安装与配置

本章节将介绍如何使用CentOS搭建GitPuk服务器，并将代码存放在GitPuk服务器，提供给Arbess克隆。

1.1 安装

本文以CentOS操作系统为例。

下载，CentOS安装包下载地址：GitPuk下载，点击CentOS下载，下载完成后得到类似tiklab-gitpuk-x.x.x.rpm的文件。
安装，上传到服务器上，在文件同级目录执行命令安装。

rpm -ivh tiklab-gitpuk-x.x.x.rpm

启动，系统默认安装路径为/opt目录，进入/opt/tiklab-gitpuk/bin目录下，执行./gitpuk start即可启动成功。

启动GitPuk系统

使用 http://ip:9800 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码。成功登录后展示GitPuk首页。

GitPuk首页

1.2 配置

GitPuk登录成功，需要添加代码仓库，GitPuk支持新建仓库上传代码和从其他软件导入仓库两种方式。

新建仓库

在仓库页面点击右上角“新建仓库”。

创建仓库

新建的仓库可通过HTTP和SSH方式按步骤上传代码。

上传代码

导入仓库

GitPuk也支持从外部仓库导入。

导入仓库

以私有Gitlab为例，导入需要提供私有Gitlab地址，以及访问密钥。

添加Gitlab信息

添加完成后，选择Gitlab的仓库，进行导入。

导入仓库

2、sourcefare 安装与配置

本章节将介绍如何使用CentOS搭建sourcefare服务，提供给Arbess调用进行代码扫描。

2.1 安装

本文以CentOS操作系统为例。

下载，CentOS安装包下载地址：Sourcefare下载，点击CentOS下载，下载安装包如tiklab-sourcefare-x.x.x.rpm。
安装，上传到服务器上，在文件同级目录执行命令安装。

rpm -ivh tiklab-sourcefare-x.x.x.rpm

启动，系统默认安装路径为/opt目录，进入/opt/tiklab-sourcefare/bin目录下，执行./sourcefare start即可启动成功。

启动

使用 http://ip:8900 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码。成功登录后展示sourcefare首页。

首页

2.2 配置

sourcefare登录成功，需要添加项目，以及代码扫描计划，Arbess运行代码扫描需要代码扫描计划ID，代码扫描报告会归类到相应代码扫描计划。

在项目页面点击新建项目按钮进行新建。输入项目名称以及项目访问信息（公开、私密）进行创建。

新建项目

成功创建扫描计划后，在扫描计划页面，需要记住ProjectKey，后期Arbess集成sourcefare需要用到，也可查看Arbess调用的历史扫描计划报告。

创建扫描计划

3、PostIn安装与配置

PostIn是一款开源免费的接口管理工具，Arbess集成PostIn，在构建前执行自动化测试用例。

3.1 安装

本文以CentOS操作系统为例。

下载，CentOS安装包下载地址：PostIn下载，点击CentOS下载，下载完成后得到类似tiklab-postin-x.x.x.rpm的文件。
安装，上传到服务器上，在文件同级目录执行命令安装。

rpm -ivh tiklab-postin-x.x.x.rpm

启动，系统默认安装路径为/opt目录，进入/opt/tiklab-postin/bin目录下，执行./postin start即可启动成功。

启动PostIn

使用 http://ip:9300 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码。

3.2 配置

成功登录后，展示PostIn功能，包含项目管理、接口管理、用例管理、测试计划等。

PostIn主页

进入项目可添加项目测试用例。

测试用例页面

在测试计划页面，添加用于Arbess构建前需要执行的测试计划。Arbess可集成PostIn，在流水线可添加任务自动执行测试计划。

添加测试计划

添加测试计划完毕之后，点击测试计划名称进入测试计划，关联自动化执行的测试用例。例如构建项目前，执行P0级接口用例。

关联用例

4、Arbess 安装与配置

4.1 安装

本文以CentOS操作系统为例。

下载，CentOS安装包下载地址：Arbess下载，点击CentOS下载，下载完成后得到类似tiklab-arbess-x.x.x.rpm的文件。
安装，上传到服务器上，在文件同级目录执行命令安装。

rpm -ivh tiklab-arbess-x.x.x.rpm

启动，系统默认安装路径为/opt目录，进入/opt/tiklab-arbess/bin目录下，执行./arbess start即可启动成功。

启动Arbess系统

使用 http://ip:9200 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码。成功登录后展示Arbess首页。

Arbess首页

4.2 配置

在流水线中可克隆GitPuk仓库代码、集成SourceFare进行代码扫描、PostIn自动化测试，配置完成流水线使用WebHook代码提交实现触发。创建流水线，进入流水线设计页面进行操作。

4.2.1 配置GitPuk源码

配置GitPuk服务集成

流水线配置GitPuk源码任务之前，需要添加GitPuk服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择GitPuk、填写名称、服务地址（即文章1部分安装的GitPuk地址)、用户名、密码。

添加源码集成

添加GitPuk源码任务

服务集成添加完毕之后，进入流水线设计，点击新阶段→源码→自建GitPuk。

配置GitPuk源码任务

字段	描述
任务名称	任务名称清晰地标识项目或对象。
Git版本	Arbess所在服务器Git安装路径。
自建GitPuk服务	自建GitPuk服务地址。
仓库	选择授权信息后点击仓库，程序会自动获取凭证权限下的仓库列表，管理者只需选择需要配置的仓库即可。
分支	选择代码的分支。填写需要拉取远程仓库具体的分支，不填默认为master分支，填写错误会导致任务执行失败。

4.2.2 配置sourcefare代码扫描

配置sourcefare服务集成

流水线配置sourcefare任务之前，需要添加sourcefare服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择sourcefare、填写名称、服务地址、认证类型（用户名密码、密钥）、用户名、密码。

添加sourcefare服务

配置sourcefare Scanner工具集成

还需要配置sourcefare Scanner工具，进入下载地址：SourceFareAgent下载。下载对应系统文件。在系统设置→集成与开放→工具集成页面添加相关服务。授权类型选择Sonar Scanner、填写名称、安装方式选择安装包，上传sourcefare Scanner工具安装包。

添加sourcefare Scanner工具

上传sourcefare Scanner工具安装包，系统会自动解析运行文件地址。

添加sourcefare Scanner工具

配置sourcefare服务集成

服务配置完成后，进入流水线设计页面，点击新阶段→代码扫描→sourcefare代码扫描。添加成功之后，弹出代码扫描的配置。

配置sourcefare代码扫描任务

字段	描述
任务名称	任务名称清晰地标识项目或对象。
扫描代码语言	扫描代码语言。
JDK版本	所在服务器JDK安装路径。
Maven版本	所在服务器Maven安装路径。
sourcefare服务	安装sourcefare的服务器地址、用户名、密码。
sourcefare Scanner版本	安装sourcefare Scanner的安装路径。
项目ID	扫描的项目ID，在sourcefare中创建的项目ID。
扫描代码地址	扫描代码存放路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。

4.2.3 配置构建任务

代码扫描添加完毕之后，添加构建安装包任务。根据代码构建方式选择Maven构建，点击新阶段→构建→Maven构建。输入构建信息，输入完成后，点击空白处进行保存。

配置Maven构建任务

字段	描述
任务名称	任务名称清晰地标识项目或对象。
JDK版本	Arbess所在服务器JDK安装路径。
Maven版本	Arbess所在服务器Maven安装路径。
模块地址	构建路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。
执行命令	执行Maven构建的命令。

4.2.4 配置部署任务

代码扫描添加完毕之后，添加部署任务。点击新阶段→部署→主机部署。输入部署信息，部署的内容可以使用变量，添加变量后使用${变量名称}进行引用，输入完成后，点击空白处进行保存。

配置主机部署任务

字段	描述
任务名称	任务名称清晰地标识项目或对象。默认主机部署。
主机地址	部署主机远程SSH认证凭证。
部署文件	需要部署的文件，可以写绝对路径，也可以写泛路径，泛路径需要配合部署文件规则来匹配到部署文件。
部署文件匹配规则	文件匹配规则，支持正则表达式。
部署位置	部署远程主机位置。
部署命令	文件部署命令。

4.2.5 配置PostIn自动化测试

配置PostIn服务集成

流水线配置PostIn任务之前，需要添加PostIn服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择PostIn、填写名称、服务地址、认证类型（用户名密码、密钥）、用户名、密码。

添加PostIn服务

添加PostIn自动化测试任务

服务配置完成后，进入流水线设计页面，点击新阶段→测试→PostIn自动化测试。添加成功之后，弹出自动化测试的配置。

配置PostIn自动化测试任务

字段	描述
任务名称	任务名称清晰地标识项目或对象。
PostIn服务	PostIn服务地址，以及用户名密码。
测试空间	选择自动执行PostIn的空间。
测试计划	选择自动执行PostIn空间下的测试计划。
环境	选择执行PostIn测试计划的环境。