Arbess从基础到实践(1) - 创建CI/CD流水线

Arbess 是一款开源免费的 CI/CD 工具，支持免费私有化部署，一键安装零配置，采用可视化设计方式，支持丰富多样的任务类型，支持分布式执行流水线。今天来介绍如何使用Arbess 配置你的第一条流水线，快速入门。

1、创建流水线

安装启动完毕后，默认可以通过 http://ip:9200 访问，默认用户名/密码为admin/123456。

默认支持通过账号密码登录，满足基础登录需求。若需要使用企业微信、钉钉或 LDAP 等高级登录方式，可参阅Arbess文档获取相关配置说明。

登录页

进入系统后，可根据不同需求来创建不同的流水线。

1.1 配置基本信息

点击流水线→新建流水线，配置流水线的基本信息，如分组，环境，权限，人员等。

新建流水线

|-------|------------------------------------------|
| 字段 | 说明 |
| 流水线名称 | 流水线名称清晰地标识项目或对象，不能重复以及输入特别字符。 |
| 流水线分组 | 流水线分组便于组织和管理流水线。 |
| 流水线环境 | 流水线环境便于组织和管理流水线。 |
| 流水线权限 | 私有：只有创建者，以及流水线成员可以看到。全局：系统内的所有人都可看到，查看。 |

1.2 选择模版

流水线信息输入完毕之后，选择流水线模板，Arbess提供了丰富的模板，使用者可以根据不同的需求选择不同的模板。

流水线模版

创建流水线成功之后，在流水线页面可浏览创建的流水线。支持通过流水线名称（模糊查询）、分组、环境、我创建的、我收藏的进行查询。

流水线页面

流水线列表支持快捷运行流水线、收藏、克隆和导出YAML文件。

流水线操作

1.3 添加成员

流水线创建成功之后，根据流水线的属性（可见范围）对访问项目的成员进行管理。

想要添加流水线成员，需要添加系统用户，依次点击系统设置->用户与权限->用户，在用户页面对系统用户进行管理。

用户列表

系统用户添加完成之后，可以对流水线成员进行添加，在流水线 详情→设置→成员，进入成员编辑页面。

成员列表

如果用户在创建流水线未选成员，那么流水线默认有创建人和admin两个成员。点击添加用户，添加的成员列表从系统用户列表获取。点击添加用户，勾选添加用户，点击确定即可成功添加流水线成员。

1.4 分配权限

添加流水线成员后，可以对成员分配权限、修改角色，点击流水线详情→设置→权限，可浏览到内置角色，也可以对角色进行新增。

角色列表

|--------|----------------------------|
| 内置角色 | 属性 |
| 流水线管理员 | 权限最大，不可指定普通成员，成员有且只有admin。 |
| 流水线成员 | 普通项目成员，权限最低，可添加多名成员。 |

在流水线详情→设置→成员，点击"角色修改"，对成员角色进行修改。成员角色可多选。

角色修改

2、配置流水线

配置流水线的任务，根据不同的需求添加不同的任务，源码，测试，部署，代码扫描，推送制品，拉取制品等几十种任务支持。

2.1 配置源码

流水线支持配置多种源码仓库，通用Git、Gitee、GitLab、GitHub、GitPuk、SVN、Gitea等。

点击新阶段 --> 点击源码 --> 选择通用Git

添加源码

|------------|-----------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| Git版本 | Arbess所在服务器Git安装路径。 |
| 自建GitPuk服务 | 自建GitPuk服务，以及用户名密码。 |
| 仓库 | 选择流水线需要获取代码的仓库。仓库下拉内容会跟随自建GitPuk服务选择变更。 |
| 分支 | 选择自建GitPuk服务的分支。 |

2.2 配置代码扫描

Arbess集成了多种代码扫描工具，SonarQube代码扫描、sourcefare代码扫描等

点击新阶段 --> 点击代码扫描 --> 选择sourcefare代码扫描任务

代码扫描

|----------------------|-----------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| 扫描代码语言 | 扫描代码语言（支持Java、JavaScript、Go）。 |
| JDK版本 | 所在服务器JDK安装路径。 |
| Maven版本 | 所在服务器Maven安装路径。 |
| SourceFare服务 | 安装SourceFare的服务器地址、用户名、密码。 |
| SourceFare Scanner版本 | 安装SourceFare Scanner的安装路径。 |
| 项目ID | 扫描的项目ID，在SourceFare中创建的项目ID。 |
| 扫描代码地址 | 扫描代码存放路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。 |

2.3 配置自动化测试

Arbess集成了PostIn自动化测试，支持在部署后自动执行PostIn测试计划。选择PostIn自动化测试，点击新阶段→测试→PostIn自动化测试。

PostIn自动化测试

|----------|-----------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| PostIn服务 | PostIn服务地址，以及用户名密码。 |
| 测试空间 | 选择自动执行PostIn的项目。 |
| 测试计划 | 选择自动执行PostIn项目下的测试计划。 |
| 环境 | 选择执行PostIn测试计划的环境。 |

2.4 配置构建

Arbess支持多种语言构建，Maven、Gradle、Node.js、Go、Docker、PHP、Python等构建方式来构建出制品。点击新阶段 --> 点击构建 --> 选择Maven构建

Maven构建

|---------|-------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| JDK版本 | Arbess所在服务器JDK安装路径。 |
| Maven版本 | Arbess所在服务器Maven安装路径。 |
| 模块地址 | 构建路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。 |
| 执行命令 | 执行Maven构建的命令。 |

2.5 配置部署

Arbess支持多种部署方式来满足用户不同的需求，自定义部署，主机部署，Docker部署，K8s集群部署等。点击新阶段 --> 点击部署 --> 选择主机部署。

主机部署

|----------|-----------------------------------------------|
| 字段 | 描述 |
| 任务名称 | 任务名称清晰地标识项目或对象。 |
| 部署方式 | 下拉选择结构化部署或者自定义命令部署。 |
| 主机地址 | 部署主机地址。以SSH的方式，需要填写主机IP、端口、用户名、密码。 |
| 部署文件 | 部署文件存放路径，默认为${DEFAULT_CODE_ADDRESS}，也可输入绝对路径。 |
| 部署文件匹配规则 | 配置部署文件，支持正则表达式。 |
| 部署位置 | 需要把文件部署在服务器的那个位置上。 |
| 部署命令 | 需要对部署文件进行怎样的操作。 |
| 部署策略 | 可选择每一批暂停部署或第一批暂停部署这两种方式。 |
| 部署主机数量 | 默认为1，如果有多个主机，可选择多个主机部署。 |