CICD实战(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://192.168.10.211" && sudo rpm -ivh gitlab-jh-x.x.x.rpm
-
安装完成之后,使用
sudo gitlab-ctl status
检查服务状态。 -
浏览器访问配置的http://192.168.10.211 ,使用用户名root,密码/etc/gitlab/initial_root_password中获取,进行登录。
1.2 配置
-
创建项目
gitlab配置完成之后,需要将代码推送到仓库中。首先在gitlab创建一个新的项目。
创建项目
-
配置本地Git
项目创建完毕之后,在本地代码文件夹,右击空白处,选择Open Git Bash here
Git推送
使用git init
初始化本地仓库。添加gitlab刚创建的远程仓库地址。
git remote add origin https://jihulab.com/ceshi4455420/tiklab-gitpuk.git
添加远程仓库地址
进入gitlab创建的项目,点击右上角的代码,获取远程仓库地址。
配置远程仓库地址
-
推送代码
首先,使用命令git add .
需要添加文件到暂存区,提交更改。
git commit -m "Initial commit"
推送到远程仓库。
git push -u origin master
代码推送完毕之后,需要创建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即可启动成功。
启动
使用 http://ip:9700 进行访问。使用初始用户名密码admin\123456登录,首次登录需要修改管理员密码,修改完成之后成功登录。
登录
2.2 配置
成功登录后,展示Hadess功能,包含制品库管理、制品搜索、制品扫描等模块。
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首页。
首页
3.2 配置
Arbess流水线采用可视化设计,实现Java项目自动化部署,在流水线中可克隆Gitlab仓库代码、集成TestHubo进行自动化测试,集成Hadess构建完成之后上传制品库。创建流水线,进入流水线设计页面进行操作。
3.2.1 配置GitLab源码
-
配置Gitlab服务集成
流水线配置GitLab源码任务之前,需要添加GitLab服务集成,在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择Gitlab、填写名称、AccessTocken(个人密钥,即文章1.2部分创建的个人访问令牌)。
添加源码集成
如需要添加自建的Gitlab,授权类型选择自建Gitlab、填写名称、服务地址、AccessTocken(个人密钥)。
添加源码集成
- 添加GitLab源码任务
服务集成添加完毕之后,进入流水线详情→设计,设计流水线,创建流水线会默认通用Git源码,一个流水线只能配置一个源码类型的的任务,修改其他类型的源码仓库,需要先删除之前的源码仓库。鼠标移动到通用Git源码,点击右侧删除按钮。
删除源码
删除后,点击流水线最左侧“+”号,添加任务,点击新阶段→源码→GitLab。需要填入任务名称、Git版本、GitLab授权信息(AccessTocken)、仓库、分支等信息。
添加源码
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
Git版本 | Arbess所在服务器Git安装路径。 |
GitLab授权信息 | 私人令牌,AccessTocken。 |
仓库 | 选择授权信息后点击仓库,程序会自动获取凭证权限下的仓库列表,管理者只需选择需要配置的仓库即可。 |
分支 | 选择代码的分支。填写需要拉取远程仓库具体的分支,不填默认为master分支,填写错误会导致任务执行失败。 |
当Gitlab授权信息错误,选择仓库,界面会给出提醒,需要确认Gitlab的个人令牌是否正常。
令牌无效
3.2.2 配置构建任务
代码扫描和自动化测试添加完毕之后,添加构建安装包任务。点击新阶段→构建→Maven构建。输入构建信息,输入完成后,点击空白处进行保存。
配置构建任务
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
JDK版本 | Arbess所在服务器JDK安装路径。 |
Maven版本 | Arbess所在服务器Maven安装路径。 |
模块地址 | 构建路径,默认为${DEFAULT_CODE_ADDRESS},也可输入绝对路径。 |
执行命令 | 执行Maven构建的命令。 |
3.2.3 配置Hadess制品库
- 配置Hadess服务集成
成功构建安装包后,可将安装包上传至Hadess,需要添加Hadess服务集成,在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择Hadess、填写名称、服务地址(制品库地址)、认证类型(用户名密码、密钥)、用户名、密码。
添加Hadess服务
- 添加Hadess制品库任务
Hadess服务添加完成后,点击新阶段→工具→Hadess上传。添加Hadess上传需要先添加Hadess服务,点击Hadess服务下拉框点击添加。
添加Hadess服务
输入名称、制品库地址(在Hadess制品库查找)、用户名、密码、
添加Hadess服务
添加成功之后,弹出Hadess上传的配置。
Hadess上传
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
Hadess服务 | 制品上传Hadess的制品库地址。 |
文件 | 需要部署的文件,可以写绝对路径,也可以写泛路径,泛路径需要配合部署文件规则来匹配到部署文件。 |
文件匹配规则 | 文件匹配规则,支持正则表达式。 |
版本 | 制品的版本。 |
4、运行流水线
- 运行流水线
流水线设计完毕之后,Arbess支持自动触发、Webhook触发、手动触发三种运行模式。点击右上角“运行”按钮,手动触发流水线。
运行流水线
流水线运行同时,点击认为标签右下角“日志”,可查看运行实时日志。
查看运行日志
运行完毕之后,登录Hadess,查看能否成功运行Hadess上传。
Hadess上传
登录Hadess系统,也可以查看到相应的制品。
Hadess制品库
- 查看运行历史
可以在Arbess历史页面查看到流水线运行历史。点击运行历史序号,即可查看详细的运行日志。
查看运行历史
至此,使用Arbess成功搭建流水线,用来拉取GitLab源码、构建安装包并上传至Hadess制品库。