Arbess 是一款国产开源免费的 CI/CD 工具，支持免费自动化部署，一键安装零配置。本文将详细介绍如何安装并使用Arbess+GitHub实现Docker项目自动化构建部署。
1、GitHub 配置
本章节将介绍如何创建GitHub个人访问令牌，提供给Arbess克隆源码。
1.1 配置
登录GitHub仓库，登录后点击右上角头像，选择Settings进入设置。
进入设置
进入设置后，点击Developer settings→Personal access tokens，进入个人令牌界面。点击创建令牌。
创建个人令牌
根据自身需求，输入名称、到期时间、访问仓库、权限等信息。
创建个人令牌
创建完成之后，保存创建的个人令牌，后续提供给Arbess调用使用。
2、Arbess 安装与配置
2.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首页
2.2 配置
Arbess流水线采用可视化设计，在流水线中可克隆GitHub仓库代码，实现Docker项目自动化部署。创建流水线，进入流水线设计页面进行操作。
2.2.1 配置GitHub源码
- 配置GitHub服务集成
流水线配置GitHub源码任务之前，需要添加GitHub服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择GitHub、填写名称、AccessTocken(个人密钥，即文章1.1部分创建的个人访问令牌)。
添加源码集成
- 添加GitHub源码任务
服务集成添加完毕之后，进入流水线设计，点击新阶段→源码→GitHub。需要填入任务名称、Git版本、GitHub授权信息（AccessTocken）、仓库、分支等信息。
添加GitHub源码任务
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
Git版本 | Arbess所在服务器Git安装路径。 |
GitHub授权信息 | 私人令牌，AccessTocken。 |
仓库 | 选择授权信息后点击仓库，程序会自动获取凭证权限下的仓库列表，管理者只需选择需要配置的仓库即可。 |
分支 | 选择代码的分支。填写需要拉取远程仓库具体的分支，不填默认为master分支，填写错误会导致任务执行失败。 |
当GitHub授权信息错误，选择仓库，界面会给出提醒，需要确认GitHub的个人令牌是否正常。
令牌无效提醒
2.2.2 配置Docker构建
点击新阶段→构建→Docker构建。添加成功之后，弹出Docker构建配置。
配置Docker构建任务
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
DockerFile地址 | 定义和自动化构建Docker镜像的脚本文件地址。 |
执行命令 | 执行Docker构建的命令。 |
2.2.3 配置Docker部署
点击新阶段→部署→Docker部署。添加成功之后，弹出Docker部署配置。
配置Docker部署任务
字段 | 描述 |
任务名称 | 任务名称清晰地标识项目或对象。 |
| 主机地址 | Docker部署文件生成的主机，远程SSH认证凭证。 |
部署镜像名称 | 需要部署的镜像名称。 |
部署位置 | 生成部署文件的位置。 |
启动命令 | 镜像启动命令。 |
3、运行流水线
- 运行流水线
流水线设计完毕之后，Arbess支持自动触发、Webhook触发、手动触发三种运行模式。点击右上角“运行”按钮，手动触发流水线。
运行流水线
流水线运行同时，点击认为标签右下角“日志”，可查看运行实时日志。
查看日志
流水线运行成功，使用docker images查看Docker部署结果。
查看部署结果
也可以通过日志来查看Docker项目生成安装包位置。
查看详细日志
- 查看运行历史
可以在Arbess历史页面查看到流水线运行历史。点击运行历史序号，即可查看详细的运行日志。
运行历史
至此，使用Arbess成功搭建流水线，用来拉取GitHub源码、Docker部署并构建安装包。
