Arbess项目实战 - 基于GitLab+SonarQube搭建Java项目自动化流水线

Arbess 是一款开源免费的 CI/CD 工具，支持免费私有化部署，一键安装零配置。本文将详细介绍如何安装配置使用GitLab、SonarQube、Arbess系统，使用Arbess流水线拉取GitLab源码、使用SonarQube进行代码扫描，构建安装包并部署到远程主机。

1、Gitlab 配置

1.1 配置访问令牌

可以将代码推送到GitLab仓库中，Arbess克隆源码需要创建GItlab的个人令牌，用于Arbess访问Gitlab。进入用户设置→访问令牌，按照需求创建创建访问令牌。

创建个人令牌

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

查看个人令牌

2、SonarQube 配置

2.1 配置项目

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

创建项目

项目创建完成之后，需要生成项目Token，点击右上角头像 → My Account → Security。输入Token名称 → 点击 Generate ，复制生成的Token。

创建Token

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

3、Arbess 安装与配置

3.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首页

3.2 配置

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

3.2.1 配置GitLab源码任务

配置GitLab服务集成

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

添加源码集成

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

添加源码集成

添加GitLab源码任务

服务集成添加完毕之后，进入流水线设计，点击新阶段→源码→GitLab。需要填入任务名称、Git版本、GitLab授权信息（AccessTocken）、仓库、分支等信息。

添加GitLab源码任务

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

3.2.2 配置SonarQube代码扫描

配置SonarQube服务集成

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

添加SonarQube服务

添加SonarQube代码扫描任务

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

配置SonarQube代码扫描任务

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

3.2.3 配置Maven构建任务

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

配置Maven构建任务

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

3.2.4 配置主机部署任务

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

配置主机部署任务

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