DevOps实战(3) - 使用Arbess+GitLab+Hadess实现Java项目自动化部署

Arbess 是一款国产开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块。本文将详细介绍如何安装配置使用GitLab、Hadess、Arbess系统，使用Arbess流水线拉取GitLab源码、构建、部署并上传Hadess制品库。

1、Gitlab 安装与配置

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

1.1 安装

安装基础依赖。

sudo yum update -y

sudo yum install -y curl policycoreutils-python-utils openssh-server perl

sudo systemctl enable --now sshd

获取Gitlab安装包。

curl -LO https://packages.gitlab.cn/repository/el/8/gitlab-jh-17.7.0-jh.0.el8.x86_64.rpm

安装Gitlab安装包。访问URL可以自己设置。

export EXTERNAL_URL="http://ip" && sudo rpm -ivh gitlab-jh-x.x.x.rpm

安装完成之后，使用sudo gitlab-ctl status检查服务状态。
浏览器访问配置的http://ip，使用用户名root，密码/etc/gitlab/initial_root_password中获取，进行登录。

1.2 配置

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

创建个人令牌

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

查看个人令牌

2、Hadess安装与配置

Hadess是一款开源免费的制品管理工具，Arbess集成Hadess，在构建完成之后将安装包自动上传到Hadess制品库。

2.1 安装

本文以CentOS操作系统为例。

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

rpm -ivh --replacefiles --nodeps tiklab-hadess-x.x.x.rpm

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

启动Hadess系统

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

2.2 配置

成功登录后，展示Hadess功能，包含制品库管理、制品搜索、制品扫描等模块。进入制品库可浏览相应的制品。

查看制品库

在制品库页面，添加用于Arbess构建后上传的制品库。Arbess可集成Hadess，在流水线可添加任务构建完成后自动上传安装包到制品库。

制品库列表

3、Arbess 安装与配置

3.1 安装

本文以CentOS操作系统为例。

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

rpm -ivh --replacefiles --nodeps tiklab-arbess-x.x.x.rpm

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

启动Arbess系统

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

Arbess首页

3.2 配置

Arbess流水线采用可视化设计，实现Java项目自动化部署，在流水线中可克隆Gitlab仓库代码、集成TestHubo进行自动化测试，集成Hadess构建完成之后上传制品库。创建流水线，进入流水线设计页面进行操作。

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分支，填写错误会导致任务执行失败。 |

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

令牌无效提醒

3.2.2 配置Maven构建任务

代码扫描和自动化测试添加完毕之后，添加构建安装包任务。点击新阶段→构建→Maven构建。输入构建信息，输入完成后，点击空白处进行保存。

配置Maven构建任务

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

3.2.3 配置主机部署任务

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

配置主机部署任务

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

3.2.4 配置Hadess制品库

配置Hadess服务集成

成功构建安装包后，可将安装包上传至Hadess，需要添加Hadess服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择Hadess、填写名称、服务地址（制品库地址）、认证类型（用户名密码、密钥）、用户名、密码。

添加Hadess服务

添加Hadess制品库任务

Hadess服务添加完成后，点击新阶段→工具→Hadess上传。添加Hadess上传需要先添加Hadess服务，点击Hadess服务下拉框点击添加。

添加Hadess服务

输入名称、制品库地址（在Hadess制品库查找）、用户名、密码、

添加Hadess服务

添加成功之后，弹出Hadess上传的配置。

配置Hadess上传任务

|----------|------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| Hadess服务 | 制品上传Hadess的制品库地址。 |
| 文件 | 需要部署的文件，可以写绝对路径，也可以写泛路径，泛路径需要配合部署文件规则来匹配到部署文件。 |
| 文件匹配规则 | 文件匹配规则，支持正则表达式。 |
| 版本 | 制品的版本。 |

至此流水线设计完毕，下面介绍流水线运行以及查看运行历史。