GitPuk是一款国产开源免费、简洁易用的代码管理工具，包含仓库管理、分支管理、代码扫描等模块本文讲为大家详细介绍如何安装GitPuk，并如何集成Arbess进行CICD自动部署
1、GitPuk安装与配置
1.1 安装
以CentOS操作系统为例。
- 下载：CentOS安装包下载地址：GitPuk下载，点击CentOS下载，下载完成后得到类似tiklab-gitpuk-x.x.x.rpm的文件。
- 安装：上传到服务器上，在文件同级目录执行npm命令安装
rpm -ivh --replacefiles --nodeps tiklab-gitpuk-x.x.x.rpm
- 启动：系统默认安装路径为/opt目录，进入/opt/tiklab-gitpuk/bin目录下，执行sh startup.sh即可启动成功
使用 http://ip:9800 进行访问。初始用户名密码admin\123456登录，首次登录根据需要修改管理员密码。成功登录后展示GitPuk首页。
1.2 配置
- 配置Arbess服务集成
在系统设置集成开放中添加。选择Arbess填写服务地址、账号密码
- GitPuk添加WebHooks
进入你创建的仓库，点击设置在仓库配置中，找到WebHooks进行添加
|-------------|--------------------------------|
| 字段 | 说明 |
| 名称 | 可根据自身输入想取的名称 |
| 路径 | ArbessWebHook地址 |
| secretToken | 类似于安全密钥，用于身份验证、授权或数据完整性验证的敏感凭证 |
1.2.1 关联CICD部署
1.进入你要关联的GitPuk代码库中，点击左侧进入关联CICD页面
2.点击关联CICD，选中你要关联的部署项目点击确定即可
2、Arbess安装与配置
2.1 安装
以CentOS操作系统为例。
- 下载：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即可启动成功。
使用 http://ip:9200 进行访问。初始用户名密码admin\123456登录，首次登录根据需要修改管理员密码。成功登录后展示Arbess首页。
2.2 配置
- 配置GitPuk服务集成
在系统设置集成开放中添加服务集成。选择GitPuk、填写名称、服务地址、认证类型（用户名密码或秘钥）、用户名、密码。
- WebHooks配置
进入到你创建的流水线，点击上方的触发设置即可查看到当前的WebHooks
2.2.1 配置GitPuk源码
进入Arbess添加流水线，点击源码自建GitPuk填好对应内容点击确定即可
|------------|------------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| Git版本 | Arbess所在服务器Git安装路径。 |
| 自建GitPuk服务 | 自建GitPuk服务地址。 |
| 仓库 | 选择授权信息后点击仓库，程序会自动获取凭证权限下的仓库列表，管理者只需选择需要配置的仓库即可。 |
| 分支 | 选择代码的分支。填写需要拉取远程仓库具体的分支，不填默认为master分支，填写错误会导致任务执行失败。 |
2.2.2 配置Maven构建
源码配置完毕后，配置构建任务，Arbess支持多种构建方式这里以Maven为例，填入对应内容后点击确定即可
|---------|-------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| JDK版本 | Arbess所在服务器JDK安装路径。 |
| Maven版本 | Arbess所在服务器Maven安装路径 |
| 模块地址 | 构建路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。 |
| 执行命令 | 执行Maven构建的命令。 |
2.2.3 配置主机部署
最后配置主机部署任务即可，点击主机部署**，**输入部署信息点击确定即可
|----------|------------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。默认主机部署。 |
| 主机地址 | 部署主机远程SSH认证凭证。 |
| 部署文件 | 需要部署的文件，可以写绝对路径，也可以写泛路径，泛路径需要配合部署文件规则来匹配到部署文件。 |
| 部署文件匹配规则 | 文件匹配规则，支持正则表达式。 |
| 部署位置 | 部署远程主机位置。 |
| 部署命令 | 文件部署命令。 |
3、运行自动化部署
3.1 触发WebHooks
1.在Arbess配置部署完成后，即可回到GitPuk中进行WebHooks的操作把已修改的代码推送至GitPuk即可。
2.推送完成后，我们可以回到Arbess进行查看WebHooks是否根据我们的推送自动的触发了本次部署
3.成功触发后，即可回到刚刚关联的CICD部署中进行查看，也可直接点击关联的部署进行详细的查看
4.可以在Arbess历史页面查看到该流水线运行历史。
5.在历史页面点击日志即可详细查看，日志详情
