Arbess 是一款国产开源免费的 CI/CD 工具,支持免费私有化部署,轻量、简洁易用。本文将介绍如何安装Arbess并创建流水线,将创建的流水线或者任务保存为模版,提供给其他流水线引用。
1、Arbess 安装与配置
1.1 安装
本文以CentOS操作系统为例。
- 下载,服务端安装包含Agent安装,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首页
1.2 配置流水线
Arbess流水线采用可视化设计,实现Java项目自动化部署,在流水线中配置通用git代码、构建安装包并部署主机。创建流水线,进入流水线设计页面进行操作。
- 添加通用git源码任务
服务集成添加完毕之后,进入流水线设计,点击新阶段→源码→通用git。需要填入任务名称、Git版本、Git仓库地址、分支、通用Git授权信息等。
添加源码任务
|---------|-------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| Git版本 | Arbess所在服务器Git安装路径。 |
| Git仓库地址 | 通用Git地址。 |
| 仓库 | 选择授权信息后点击仓库,程序会自动获取凭证权限下的仓库列表,管理者只需选择需要配置的仓库即可。 |
| 通用git服务 | 通用Git授权信息。 |
- 配置Maven构建任务
代码扫描添加完毕之后,添加构建安装包任务。根据代码构建方式选择Maven构建,点击新阶段→构建→Maven构建。输入构建信息,输入完成后,点击空白处进行保存。
配置Maven构建任务
|---------|-------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| JDK版本 | Arbess所在服务器JDK安装路径。 |
| Maven版本 | Arbess所在服务器Maven安装路径。 |
| 模块地址 | 构建路径,默认为${DEFAULT_CODE_ADDRESS},也可输入绝对路径。 |
| 执行命令 | 执行Maven构建的命令。 |
- 配置主机部署任务
点击新阶段→部署→主机部署。输入部署信息,部署的内容可以使用变量,添加变量后使用${变量名称}进行引用,输入完成后,点击空白处进行保存。
配置主机部署任务
|----------|------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。默认主机部署。 |
| 主机地址 | 部署主机远程SSH认证凭证。 |
| 部署文件 | 需要部署的文件,可以写绝对路径,也可以写泛路径,泛路径需要配合部署文件规则来匹配到部署文件。 |
| 部署文件匹配规则 | 文件匹配规则,支持正则表达式。 |
| 部署位置 | 部署远程主机位置。 |
| 部署命令 | 文件部署命令。 |
至此流水线设计完毕,下面介绍流水线自定义模版,支持流水线模板和任务模版。
- 流水线模板:将整条流水线作为模板,创建流水线可直接引用模版创建流水线。
- 任务模版:将流水线单独任务作为模板,流水线新增任务可引用模版进行新增。
1、流水线模板
1.1 保存模版
流水线创建完毕之后,点击流水线设计页面右上角"...",选择保存为模板。
保存为模版
输入模版名称进行保存,保存完成后,进入系统设置→流水线配置→模版进行管理。
模版
点击流水线模板名称,可以编辑流水线的模板。
编辑流水线模版
1.2 引用模版
模版保存后,创建流水线选择模版,可选择自定义模版。
选择自定义模版
选择自定义模版进行创建,创建完成后流水线显示为保存的模版。
使用模板创建流水线
2、任务模版
2.1 保存模板
流水线创建完毕之后,点击流水线任务,点击流水线任务右上角"...",选择保存为模板。
保存为模版
输入模版名称进行保存,保存完成后,进入系统设置→流水线配置→模版进行管理。
模版管理
点击模版名称,可以对模版信息进行编辑。
编辑模版
2.2 引用模板
任务模版保存完毕之后,流水线编辑点击添加任务,可以引用流水线任务模版。
引用任务模版
任务模版可设置是否模版同步,开启模版同步后,引用的任务模版只允许在系统设置中编辑,并且系统设置中编辑后,所有引用任务模版的流水线同步进行编辑。
模版同步
例如下图任务模块开启模块同步,流水线设计不允许编辑,在系统设置修改任务模块。流水线中任务模块会同步修改。
同步任务模版
下图任务模块未开启模块同步,流水线设计允许编辑。
不同步模版
欢迎有兴趣的开发者朋友前往官网体验demo,或者免费下载私有化部署版本下载体验。