文档

构建集群

更新时间:

本文主要介绍流水线执行依赖的构建集群,云效 Flow 提供默认构建集群,此外为了满足企业定制化场景,也支持企业接入自己的机器作为私有构建集群。

云效默认构建集群

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

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

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

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

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

Flow 服务端 IP 地址

112.126.70.240,123.56.255.38,47.94.150.88

Flow 云效北京构建集群 IP 地址

47.93.89.246,47.94.150.17

Flow 云效中国香港构建集群 IP 地址

47.57.70.87,47.242.65.197,47.90.29.115,47.57.136.136

image

私有构建集群

如果对构建环境有特殊的需求,云效 Flow 也支持接入您自己的机器作为私有构建集群,支持阿里云ECS或其他自有主机。云效 Flow 使用容器化构建方式,流水线任务会随机调度到私有构建集群的一台机器上,并启动相应的容器环境执行任务。

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

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

  • 操作系统架构:Linux/amd64、Linux/arm64,支持以下 Linux 发行版本:

    • CentOS 6+ 及以上

    • Ubuntu 16.04+ 及以上

    • Alibaba Cloud Linux 2/3

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

  • 安装并启动了 Docker Daemon:https://docs.docker.com/engine/install/。验证 Docker 运行状态:在主机上执行命令 sudo docker ps; echo $?,输出为 0则 Docker 运行状态正常。

  • 对于以 阿里云ECS 方式添加的机器还需要启动、停止或者卸载云助手Agent

新建私有构建集群

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

image.png

接入新节点

进入 Flow 首页 > 企业设置 > 构建集群管理,找到目标构建集群,单击进入构建集群详情页,单击接入新节点

  • 操作系统类型:目前仅支持接入 Linux 机器作为构建节点,支持 amd64、arm64 架构。

  • 添加方式:

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

    image

    image

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

      • 选择 服务连接

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

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

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

image

构建集群管理

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

  • 查看构建集群主机列表,展示:

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

    • IP:主机接入时,自动读取主机的IP

    • 主机名:主机接入时,自动读取主机的hostname

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

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

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

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

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

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

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

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

image

使用私有构建集群

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

image

Runner常用操作

安装Runner

私有构建集群详情页,接入新节点,复制Runner安装命令到机器上执行。详见:接入新节点

查看Runner状态

  • 第1步,先执行以下命令查看 Runner 服务名称。通常 Runner 服务的名称为 runner-{版本}-{租户名称}.service

ls -al /etc/systemd/system | grep runner

image

  • 第2步,拿到 Runner 服务名称,执行以下命令查看服务状态。如果返回 Active:active(running),则服务正常。

systemctl status runner-{版本}-{租户名称}.service

image

查看Runner日志

执行以下命令,查看 Runner 执行日志。

journalctl -u runner-{版本}-{租户名称}.service -a --no-pager --since '5 minutes ago' -f

重启Runner

执行以下命令,重启 Runner 服务。

systemctl restart runner-{版本}-{租户名称}.service

卸载Runner

执行以下命令,卸载 Runner 服务。

systemctl stop runner-{版本}-{租户名称}.service
rm -rf /etc/systemd/system/runner-{版本}-{租户名称}.service
rm -rf /root/yunxiao/{租户名称}/runner/config
  • 本页导读 (0)
文档反馈