Arbess 是一款国产开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块。本文将详细介绍如何创建配置流水线实现项目K8s部署，并使用Webhook自动触发运行流水线。
1、Gitee 安装与配置
本章节将介绍如何使用创建Gitee个人密匙，提供给Arbess克隆。
1.1 配置
首先需要登录Gitee仓库，登录后点击右上角头像，选择账号设置进入设置。
进入账号设置
进入设置→私人令牌→生成新令牌。根据自建需求，输入名称、到期时间、私人令牌权限等信息。
创建个人令牌
创建完成之后，保存创建的个人令牌，后续集成到Arbess需要用到。
生成私人令牌
2、Arbess 安装与配置
2.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目录下，执行./arbess start即可启动成功。
启动Arbess系统
使用 http://ip:9200 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码。成功登录后展示Arbess首页。
Arbess首页
2.2 配置
Arbess流水线采用可视化设计，实现Java项目自动化部署，在流水线中可克隆Gitee仓库代码、构建安装包，并部署到Kubernetes。创建流水线，进入流水线设计页面进行操作。
2.2.1 配置Gitee任务
- 配置Gitee服务集成
流水线配置Gitee源码任务之前，需要添加Gitee服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择Gitee、填写名称、AccessTocken（即文章1部分Gitee个人密钥)。
添加源码集成
- 添加Gitee源码任务
服务集成添加完毕之后，进入流水线设计，点击新阶段→源码→自建Gitee。需要填入任务名称、Git版本、自检Gitee服务、仓库、分支等信息。
配置Gitee源码任务
|-----------|------------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| Git版本 | Arbess所在服务器Git安装路径。 |
| Gitee授权信息 | 填写Gitee的授权信息。 |
| 仓库 | 选择授权信息后点击仓库，程序会自动获取凭证权限下的仓库列表，管理者只需选择需要配置的仓库即可。 |
| 分支 | 选择代码的分支。填写需要拉取远程仓库具体的分支，不填默认为master分支，填写错误会导致任务执行失败。 |
2.2.2 配置Docker构建任务
源码配置完毕后，配置构建任务，Arbess支持多种构建方式，例如添加Docker构建，点击新阶段→构建→Docker构建。
配置Docker构建任务
|--------------|--------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| DockerFile地址 | 定义和自动化构建Docker镜像的脚本文件地址。 |
| 执行命令 | 执行Docker构建的命令。 |
2.2.3 配置Docker部署任务
点击新阶段→部署→Docker部署。添加成功之后，弹出Docker部署配置。
配置Docker部署任务
|--------|----------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| 主机地址 | Docker部署文件生成的主机，远程SSH认证凭证。 |
| 部署镜像名称 | 需要部署的镜像名称。 |
| 部署位置 | 生成部署文件的位置。 |
| 启动命令 | 镜像启动命令。 |
2.2.4 配置Kubernetes部署任务
- 工具集成
添加Kubernetes部署任务之前，需要先维护kubectl版本和Kubernetes集群，点击系统设置→集成开放→工具集成。
配置kubectl版本
kubectl版本维护完成之后，点击系统设置→资源配置→Kubernetes集成。使用Kubeconfig文件进行配置。
配置Kubernetes集群
- 配置Kubernetes部署任务
kubectl版本和Kubernetes集群维护完成之后，在流水线添加Kubernetes部署任务。
配置Kubernetes部署任务
|----------|-----------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| 集群地址 | 维护的Kubernetes集群地址。 |
| 配置文件类型 | Kubernetes集群部署方式。 |
| 配置文件位置 | 构建路径，默认为${DEFAULT_CODE_ADDRESS}，即克隆源码保存路径，也可输入绝对路径。 |
| 配置文件匹配规则 | 执行Maven构建的命令。 |
3、运行流水线
- 运行流水线
任务添加完成之后，对流水线手动运行，运行流水线的同时可查看流水线的运行状态及日志。
运行流水线
运行流水线的同时可查看流水线的运行状态及日志。
查看详细日志
- 配置Webhook触发
可以成功运行流水线之后，需要设置Webhook触发，在流水线设计点击"触发设置"。
配置触发条件
开启Webhook，将Webhook地址填入代码仓库Webhook设置地址，实现仓库推送，发送HTTP/HTTPS的目标通知地址，从而触发Arbess流水线。
开启Webhook设置
- 查看运行历史
可以在Arbess历史页面查看到流水线运行历史。点击运行历史序号，即可查看详细的运行日志。
查看运行历史
至此，流水线创建完毕，当代码仓库完成推送即可触发流水线进行K8s部署。