构建集群

1. 云效默认构建集群

Flow 提供默认构建资源，提供 云效北京构建集群 和 云效中国香港构建集群 两个默认构建集群。

• 流水线会为每个构建任务分配一个全新的容器构建环境，任务结束环境回收。

• 容器构建环境操作系统默认为Linux、amd64架构，云效会根据任务类型指定不同的容器镜像，预装相应的SDK和环境。

• 容器构建环境规格默认 1C1G，Node相关任务 4C8G，其他任务 3C6G。

当你的某些依赖服务开启了白名单，则需要在白名单中设置 Flow 构建机的 IP 地址。如，当你的代码仓库开启了白名单，则需要在对应的代码仓库添加以下 IP，Flow 构建机才可完成对应仓库的代码克隆。

2. 私有构建集群

如果对构建环境有特殊的需求，云效 Flow 也支持接入您自己的机器作为私有构建集群，支持阿里云ECS或其他自有主机。云效 Flow 流水线支持容器构建环境、VM构建环境，流水线任务会按需调度到私有构建集群的机器上执行。

2.1 前提条件

机器接入前请检查机器满足以下条件：

• 机器需要可访问公网（用于云效 Runner 安装回调、流水线构建任务依赖下载及回调等）

• 目前云效支持接入以下操作系统架构机器作为私有构建机：

  • Linux

    • 支持以下 Linux 发行版本：CentOS 6+ 及以上、Ubuntu 16.04+ 及以上、Alibaba Cloud Linux 2/3

    • 架构：支持 Linux/amd64、Linux/arm64 架构

    • 推荐配置：4核8G及以上

    • 构建环境：目前 Linux 构建机器仅支持 默认环境、默认VM环境，需要机器安装并启动了 Docker Daemon：https://docs.docker.com/engine/install/ 。验证 Docker 运行状态：在主机上执行命令sudo docker ps; echo $?，输出为0则 Docker 运行状态正常。

  • Windows

    • 支持以下 Windows 版本：Windows 2012、Windows 2016、Windows 2019、Windows 2022

    • 架构：支持 Windows/amd64 架构

    • 构建环境：目前 Windows 构建机器仅支持 默认VM环境

  • macOS

    • 支持以下 macOS 版本：macOS Sonoma(14.0)、macOS Ventura(13.0)、macOS Monterey(12.0)

    • 架构：支持 macOS/amd64、macOS/arm64 架构

    • 构建环境：目前 macOS 构建机器仅支持 默认VM环境

2.2 新建私有构建集群

进入 Flow 首页 > 全局设置 > 构建集群管理 > 新建构建集群，填写构建集群名称、标签、拥有者等信息，单击确定即可新建一个构建集群。

2.3 接入新节点

进入 Flow 首页 > 企业设置 > 构建集群管理，找到目标构建集群，单击进入构建集群详情页，单击接入新节点。目前支持接入 Linux（amd64/arm64架构）、Windows（amd64架构）、macOS（amd64/arm64架构）机器作为构建机。

接入 Linux 构建机

支持 手动安装Runner 和 阿里云ECS 两种方式接入 Linux 构建机：

• 手动安装Runner：直接复制 Runner 安装命令在待接入的机器上执行，Runner 安装成功后，新机器将自动添加至当前集群，请刷新主机列表后查看。

• 阿里云ECS：如果待接入机器为阿里云 ECS，你还可以通过选择 阿里云ECS 接入方式直接添加，云效 Flow 会自动帮你安装 Runner。

  • 选择 服务连接

  • 选择待添加机器所在 地域

  • 在 可添加主机列表 勾选待添加机器

  • 单击确定即可自动添加机器进入构建集群

接入 Windows 构建机

支持 手动安装Runner 和 阿里云ECS 两种方式接入 Linux 构建机：

• 手动安装Runner：Windows机器上，打开 PowerShell 以 Administrator 用户执行 Runner 安装命令。Runner 安装成功后，新机器将自动添加至当前集群，请刷新主机列表后查看。

• 阿里云ECS：如果待接入机器为阿里云 ECS，你还可以通过选择 阿里云ECS 接入方式直接添加，云效 Flow 会自动帮你安装 Runner。

  • 选择 服务连接

  • 选择待添加机器所在 地域

  • 在 可添加主机列表 勾选待添加机器

  • 单击确定即可自动添加机器进入构建集群

接入 macOS 构建机

支持 手动安装Runner 方式接入 macOS 构建机：macOS机器上，直接复制 Runner 安装命令在待接入的机器上执行，Runner 安装成功后，新机器将自动添加至当前集群，请刷新主机列表后查看。

2.4 构建集群管理

进入 Flow 首页 > 企业设置 > 构建集群管理，找到目标构建集群，单击进入构建集群详情页。

• 查看构建集群主机列表，展示：

  • 实例ID：主机接入时，为主机自动生成的唯一ID

  • IP：主机接入时，自动读取主机的IP

  • 主机名：主机接入时，自动读取主机的hostname

  • 操作系统/架构：主机接入时，自动读取主机的操作系统和架构

  • 占用情况：本主机是否还存在于其他构建集群

  • Runner状态：本主机上 Runner 的连接状态

  • 安装进度：以 阿里云ECS 方式添加的机器，可以查看 Runner 的安装进度及日志

• 重装Runner：以 阿里云ECS 方式添加的机器，当机器 Runner 状态异常时，可直接通过页面重装Runner。

• 移除节点：移除节点仅将节点从当前构建集群解除绑定，并不会删除真实机器，也不会卸载Runner（如有需要请参照以下 Runner 常用操作手动卸载）。

• 设置集群：可以修改构建集群名称、标签等。

• 删除集群：删除集群仅会将节点从当前构建集群中解除绑定，并删除集群数据，但并不会删除真实机器，也不会卸载Runner（如有需要请参照以下 Runner 常用操作手动卸载）。

2.4 使用私有构建集群

进入目标流水线编辑页面，流水线任务 构建集群 可以选择企业创建好的私有构建集群。流水线运行时，任务会随机调度到一台构建机器上执行，私有构建集群的构建时长和并发任务数不计入企业构建配额。

更多参考

• 流水线 Runner

• Runner 常见问题