注：docker环境下，Arbess无法访问到宿主机上的文件，需要挂载后才可访问。

注：docker环境挂载必须挂载源文件，挂载链接库文件可能会导致执行异常。

下找不到可执行的文件，如图是因为配置的

找不到执行文件，即在Linux环境下没有 

文件，同理maven、node、go等环境一样的，找不到对应程序的可执行文件。

工具集成配置异常解决

常见问题

Arbess

Arbess - 文档

关于Arbess

Arbess社区版需要升级企业版，首先先需要确定当前版本，在

，可以找到当前的版本类型，点击“企业版特性”可以浏览到社区版和企业版功能对比。

如需要升级企业版，点击右侧订阅按钮。

点击订阅按钮，页面打开官网，用户需要经过登录后，进入订阅管理，选Arbess点击订阅。

在订阅页面输入需要购买的时长和购买数量（即需要使用系统的用户数量），确认无误后，点击前往支付。

其中根据购买时长、购买数量价格上会有不同优惠。

支付完成后，在已订阅会显示订阅的产品，点击订阅的产品右侧的“licence”。

在弹出的窗口填入Arbess服务器的MAC地址，即可升级企业版。

订阅成功后，在订阅管理可以查看已购产品订阅的版本、订阅人数、订阅有效期，已订阅的产品进行续订和扩容。

社区版与企业版的区别

加入我们的技术交流群，参与互动交流，提升自我。

联系我们

产品介绍

启动完成后，这样你就可以通过 

 访问 Arbess 界面了，并且Abess支持多种登录类型，本地登录与统一登录。

初始化账号为：admin ,密码为：123456，

Arbess支持用户自定义端口、数据库、统一登录等配置，用户可以根据自己的需求来更改，只需要编辑默认文件

application.yaml即可。Arbess的配置文件位置：默认在/opt/tiklab-arbess/conf 目录下

支持用户自定义数据的保存位置。

Arbess同时支持用户使用外部数据库以及内嵌数据库

外部数据库：用户自己定义链接数据库的地址，用户名，密码等。

内嵌数据库：使用系统内置的数据库

统一登录，即使用统一使用soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。

可以安装多个Agent来连接一个配置端，做到一个配置端，多个执行端，分布式部署。

程序安装结束后，可以在系统执行如下。

使用 arbess -v 或者 arbess version 查看当前安装版本。

Arbess安装默认为免费版，导入Licnece即可使用企业版功能。

Arrbess支持用户试用功能，用户可选择使用，直接使用企业版功能。

--> 点击左上角登录 --> 点击左上角头像进入个人中心 --> 点击订阅 --> 点击订阅管理 --> 选择Arbess --> 点击企业版试用

用户可选择订阅时长，以及订阅人数，满足不同企业的要求。

--> 点击左上角登录 --> 点击左上角头像进入个人中心 --> 点击订阅 --> 点击订阅管理 --> 选择Arbess --> 点击订阅

订阅或者试用完成后，可在订阅管理中已订阅中看到Arbess的订阅记录。

点击Arbess订阅记录后的Licence按钮  --> 浏览器提示下载一个以lic结尾的文件 --> 等待浏览器下载完成即可。

Linux 安装配置

Arbess-linux安装

Arbess支持用户自定义，数据库，备份，统一登录等配置，用户可以根据自己的需求来更改，只需要编辑默认文件

application.yaml即可。Arbess的配置文件位置：默认在/opt/tiklab-arbess/conf 目录下。

Arbess支持用户使用脚本一键更新脚本，只需要执行应用跟新脚本即可。

Arbess支持在线直接升级功能，用户导入Licence即可使用企业版功能。

点击左下角设置图标 --> 点击应用 --> 点击版本与许可证 --> 点击右上角导入Licence --> 选择上边下载的Licence即可。

导入完成后可以看到以下界面，即导入Licence成功。

Docker 安装配置

application.yaml即可。Arbess的配置文件位置：默认在安装位置tiklab-arbess/conf 目录下

Windows 安装配置

application.yaml即可。Arbess的配置文件位置：默认在在 app 的Contents下的 conf目录下

统一登录，即统一使用soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。

MacOS 安装配置

安装配置

流水线用来帮助企业实现代码从开发到生产环境的全流程自动化，提升软件交付效率和质量。本文将详细介绍如何对流水线进行管理。流水线管理包含对流水线进行创建、添加用户、修改、删除。

可根据不同需求来创建不同的流水线。在流水线页面，点击

点击下一步，进入流水线模版选择页面。提供了丰富的模板，使用者可以根据不同的需求选择不同的模板。

创建流水线成功之后，在流水线页面可浏览创建的流水线。支持通过流水线名称（模糊查询）、分组、环境、我创建的、我收藏的进行查询。

流水线列表显示流水线的名称、最近构建信息（时间、构建次数、最近一次构建结果）、负责人、可见范围。

流水线列表支持快捷运行流水线、收藏、克隆和导出YAML文件。

添加流水线成员之前，需要添加系统用户，依次点击

，展示用户列表。系统内置管理员用户，无法删除。

点击“添加用户”，展现添加用户弹窗。

添加账号成功之后，可以对账号进行编辑、修改密码、重置密码、删除。

系统用户添加完成之后，可以对流水线成员进行添加，在

如果用户在创建流水线未选成员，那么空间默认有创建人和admin两个成员。点击添加用户，添加的成员列表从系统用户列表获取。

勾选添加用户，点击确定即可成功添加空间成员。

添加流水线成员后，对成员修改角色，点击

，点击“角色修改”，对成员角色进行修改。成员角色可多选。

还可以对流水线的基本信息进行编辑，在流水线详情，点击

设置→流水线信息→流水线删除

注意，流水线删除之后无法恢复，请慎重操作。

成功创建流水线之后，默认进入流水线详情，在流水线详情对流水线进行管理。

流水线详情——概况，展示流水线发布情况。

流水线详情——设计，设计流水线页面。

流水线详情——历史，查看流水线执行历史。

流水线详情——测试报告，流水线配置代码扫描或者测试的时候，执行流水线会在测试报告中生成相应代码扫描、测试结果。

流水线详情——统计，显示流水线运行统计和结果统计。

流水线管理

设计流水线

流水线设计完成之后，需要运行流水线。﻿本文将详细介绍如何运行流水线，并查看运行日志及结果。

成功设计流水线后，对流水线进行运行，可以选择在不同的agent中执行，在官网可以下载Arbess Agent，添加不同的agent进行执行。

如果未安装其他Agent，默认使用本地的Agent运行即可，点击右上角运行。

点击运行弹出运行过程，可以实时查看流水线运行信息，点击任务的日志按钮可以查看任务的具体输出的日志。

除了手动触发流水线，还可以通过定时任务自动触发，分为单次触发和周期触发。

设计→触发设置→添加→单次触发。

设置触发时间，点击确定，触发设置列表会新增一条“未触发”的定时任务。

单次触发流水线的定时任务触发后，触发状态会变更为“已触发”。

周期触发，以周为单位，循环触发。点击

设计→触发设置→添加→周期触发。

设置触发时间，点击确定，触发设置列表会新增一条“未触发”的定时任务，并且周期触发触发状态永远是“未触发”。

例如下图，设置周一和周日凌晨2点，分别自动运行流水线。

触发方式不同在历史列表显示的触发信息也不同。

在运行过程中可以根据显示成功或者失败的日志，调整流水线的设计。

运行结束后，点击流水线详情的历史页面，查看该条流水线运行历史。历史列表支持流水线名称模糊查询，以及执行人（流水线成员）、状态（成功、失败、停止、运行中）、执行方式（自动、手动、回滚）下拉查询。

点击历史列表序号，可查看具体任务日志详情，可以看到任务的具体日志输出。

流水线配置并运行代码扫描后，在

可以查看代码的具体扫描结果。

点击序号，可以查看各种Bug数量，级别，bug的优先级，以及出现bug的原因，具体行数等信息。

流水线配置并运行Maven单元测试后，在

流水线配置并运行TestHubo自动化测试后，在

点击运行结果名称，进入TestHubo系统查看详细运行结果。

运行流水线

从多个维度查看流水线的结果统计信息，如结果数量，结果概率等，同时支持查看近7天，14天，30天，90天的统计信息。

运行统计显示流水线运行时间段统计、平均执行市场趋势、成功率趋势、失败率趋势、终止率趋势。

显示结果数量统计、结果概率统计。

统计分析

快速入门

常用流水线显示的是最近打开或经常使用的流水线。

运行统计展示的是当天运行的流水线统计

统计当天流水线发布次数Top10统计，以及人员Top10统计

首页

查询流水线

新建流水线

更新流水线

删除流水线

流水线概况

流水线历史

流水线流程设计

流水线成员

流水线权限

流水线消息通知方案

流水线设置

流水线

流水线执行是有前到后，即前一个阶段全部执行完成后，下一个阶段才会开始执行。

各个阶段可以创建并行任务与串行任务。

并行任务表示同时执行，即当流水线运行时此阶段是并行任务会同时开始执行。

如图所示：spotBugs-Java代码扫描与SonarQube为并行任务，流水线运行时会同时开始运行。

串行任务表示依次执行，即当流水线运行时此阶段是串行任务会依次开始执行。

如图所示：spotBugs-Java代码扫描与Maven单元测试为串行任务，流水线运行时先执行spotBugs-Java代码扫描再执行Maven单元测试。

各个阶段有各个阶段的名称，可以自定义。

每个阶段任务拥有各自名称，可以自定义。

进入设计 --> 点击新阶段 --> 选择新阶段任务即可添加新阶段。

鼠标放在已经创建的的任务上，任务左右即可出现添加按钮，点击前方按钮会在当前任务前方插入选择的任务，点击后方按钮会在任务后方加入选择的任务。

鼠标放入需要添加并行任务的阶段内，点击添加并行阶段，选择需要添加的任务，即可添加成功。

点击阶段与阶段直接的添加按钮，选择阶段任务，即可添加成功。

流水线创建成功后进入此界面或点击设计即可查看此界面

点击名称更新按钮，右侧出现名称修改框，输入新的阶段名称即可。

鼠标放到需要删除的任务上会出现删除按钮，点击删除按钮，点击确定即可删除该任务，当阶段任务全部被删除时，阶段会自动删除。

阶段

源码

代码扫描

测试

构建

拉取制品

推送制品

部署

任务

用户与权限

分组

环境

主机

主机组

认证

工具

流水线配置

服务集成

资源监控

系统设置

使用指南

​Arbess 是一款开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块。本文将详细介绍如何安装配置使用GitLab、SonarQube、Arbess系统，使用流水线拉取GitLab源码、使用SonarQube进行代码扫描，构建安装包并部署到主机。

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

gitlab配置完成之后，需要将代码推送到仓库中。首先在gitlab创建一个新的项目。

项目创建完毕之后，在本地代码文件夹，右击空白处，选择 Open Git Bash here 。

使用git init初始化本地仓库。添加gitlab刚创建的远程仓库地址。

进入gitlab创建的项目，点击右上角的代码，获取远程仓库地址。

首先，使用命令git add .需要添加文件到暂存区，提交更改。

代码推送完毕之后，需要创建GItlab的个人令牌，用于Arbess访问Gitlab。点击极狐GitLab


令牌创建完毕，请妥善保存好您的令牌。

本章节将介绍如何使用CentOS9搭建SonarQube25.1服务，在SonarQube创建项目，提供给Arbess调用。

安装SonarQube依赖Java17和PostgreSQL ，首先先安装Java17。

其次安装PostgreSQL，SonarQube 25.1要求PostgreSQL 13-16版本。依次执行如下命令，添加

官方仓库→安装→初始化数据库→重启服务

安装PostgreSQL数据库之后，执行如下命令，创建数据库

SonarQube→创建用户名密码→赋予权限


数据库创建完成之后，可以修改数据库认证配置，编辑/var/lib/pgsql/15/data/pg_hba.conf，在最下方添加如下内容，并重启服务。

重启服务：sudo systemctl restart postgresql-15

依赖安装完毕之后，安装SonarQube 25.1。

修改SonarQube数据连接信息。编辑/opt/sonarqube/conf/sonar.properties。

修改完成后进入，启动SonarQube服务。


安装成功后访问 http://127.0.0.1:9000 地址使用用户名密码：admin\admin，访问SonarQube。

登录SonarQube系统后，需要创建项目，以及将代码导入项目进行分析。在SonarQube首页，点击Create Project，创建项目。

输入项目名称、项目Key，点击下一步进行创建。

项目创建完成之后，需要生成项目Token，点击右上角


创建完毕之后，需要记住token和项目名称，Arbess集成SonarQube需要用到。


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


Arbess流水线采用可视化设计，实现Java项目自动化部署，在流水线中可克隆Gitlab仓库代码、集成SonarQube进行代码扫描。创建流水线，进入流水线设计页面进行操作。


流水线配置GitLab源码任务之前，需要添加GitLab服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择Gitlab、填写名称、AccessTocken(个人密钥，即文章1.2部分创建的个人访问令牌)。

如需要添加自建的Gitlab，授权类型选择自建Gitlab、填写名称、服务地址、AccessTocken(个人密钥)。


服务集成添加完毕之后，进入流水线详情→设计，设计流水线，创建流水线会默认通用Git源码，一个流水线只能配置一个源码类型的的任务，修改其他类型的源码仓库，需要先删除之前的源码仓库。鼠标移动到通用Git源码，点击右侧删除按钮。

删除源码任务后，点击流水线最左侧“+”号，添加任务，点击

。需要填入任务名称、Git版本、GitLab授权信息（AccessTocken）、仓库、分支等信息。


当Gitlab授权信息错误，选择仓库，界面会给出提醒，需要确认Gitlab的个人令牌是否正常。


流水线配置SonarQube任务之前，需要添加SonarQube服务集成，在

系统设置→集成与开放→服务集成

页面添加相关服务。授权类型选择Sonar、填写名称、服务地址、认证类型（用户名密码、密钥）、用户名、密码。