1. 持续集成
  2. 词汇表
持续集成 / 构建节点类型 / 自定义节点

自定义节点

功能介绍

在实际的开发项目中,所涉及的开发环境可能是多种多样的,当默认节点的构建环境无法承载项目的持续集成要求时,例如需要使用 macOS Xcode 构建 iOS 应用时,就可以通过接入自定义类型节点(物理机/虚拟机/容器等)运行特定任务。

构建节点池分为团队与项目两种类型,构建节点与构建节点池为一一对应关系,构建节点不能游离节点池而单独运行构建计划。

接入节点

接入自定义节点的过程本质上是在节点中运行一个 cci-agent 服务,目前 cci-agent 支持 Docker / war 两种构建环境,点击了解 cci-agent 详情

进入需接入自定义节点的项目中,点击左侧菜单栏的「持续集成」→「构建节点」,轻点右上角的接入新节点按钮。

目前支持 macOSWindowsLinux 环境接入至构建计划节点池。

推荐配置

  • CPU 8 核或以上
  • 内存 16 GB 或以上
  • 如果要使用 Docker 运行构建节点,请先安装 Docker >= 19

macOS

环境依赖

  • Git>=2.9
  • 如果要使用 Docker 运行构建节点,请先安装 Docker >= 19,安装命令:
brew cask install docker

使用脚本快速接入

进入构建节点,选择【接入新节点】->【 macOS 】,接入方式选择 Bash,选择对应节点池,点击【生成接入配置并复制】。如果想要使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。点击【生成接入配置并复制】后,在计算资源中的终端运行复制的命令即可触发接入。

手动接入

  1. 在【项目设置】->【开发者选项】->【项目令牌】里新建一个拥有「构建节点权限」的项目令牌。

  1. 进入构建节点,选择【接入新节点】->【macOS】,接入方式选择手动接入,选择对应客户端下载并放置在计算资源的自定义目录下。

  2. 选择对应节点池,如果要使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。

  3. 如果已经建立好项目令牌,可以点击【一键生成并复制】,在放置客户端的目录下执行已复制的初始化命令。

  4. 执行已自动生成的客户端启动命令,让构建节点保持在线状态。

成功接入

成功接入并启动节点后,可以看到成功信息。如果节点配置小于推荐配置,系统会提示信息。

INFO[2020-06-17 14:39:39] Download tools.
Downloading jenkinsHome.zip ................................................................................................  Done
Downloading jenkins.war ............  Done
++++++++++++++++++++++++++++++++++++++++
----> Start agent
INFO[2020-06-17 14:43:11] 连接成功
WARN[2020-06-17 14:43:13] 当前节点配置小于 CODING 自定义构建节点的推荐配置要求

  配置项  当前配置  最小配置要求  推荐配置  
--------------------------------------------
  CPU     2 核      2 核          >= 4 核
  内存    8 GB      4 GB          >= 16 GB  
--------------------------------------------

INFO[2020-06-17 14:43:13] Success.

成功接入后,接入文件夹下可以看到 cci-agent。

agent1:agent user$ ls
cci-agent

在对应的节点池中也可以看到成功接入的节点处于闲置状态,表示可用于执行构建计划。

Windows

环境依赖

  • Git>=2.9
  • 如果要使用 Docker 运行构建节点,请先安装 Docker >= 19,安装 Docker

使用脚本快速接入

选择【持续集成】->【构建节点】中,点击右上角的【接入新节点】,选中 Windows,选择 Powershell 接入方式。设置完成后在本地运行已生成的接入配置命令。如果希望使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。

手动接入

  1. 在【项目设置】->【开发者选项】->【项目令牌】里新建一个拥有「构建节点权限」的项目令牌。

  1. 进入构建节点,选择【接入新节点】->【Windows】,接入方式选择手动接入,选择对应客户端下载并放置在计算资源的自定义目录下。

  2. 选择对应节点池,如果要使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。

  3. 如果已经建立好项目令牌,可以点击【一键生成并复制】,在放置客户端的目录下执行已复制的初始化命令。

  4. 执行已自动生成的客户端启动命令,让构建节点保持在线状态。

成功接入

成功接入并启动节点后,可以看到成功信息。如果节点配置小于推荐配置,系统会提示信息。

Status: Downloaded newer image for coding-public-docker.pkg.coding.net/cci/agent-docker/jenkins-cci:agent-v2

----> Start agent
.\cci-agent.exe up -s cci-websocket.coding.net --insecure=false -d
time="2020-06-17 17:54:30" level=info msg="连接成功"
time="2020-06-17 17:54:34" level=info msg=Success.

成功接入后,接入文件夹下可以看到 cci-agent。

agent1:agent user$ ls
cci-agent

在对应的节点池中也可以看到成功接入的节点处于闲置状态,表示可用于执行构建计划。

Linux

环境依赖

  • Git>=2.9
  • 如果要使用 Docker 运行构建节点,请先安装 Docker >= 19,安装 Docker 的命令:
curl -fsSL https://get.docker.com/ | sh

脚本快速接入

选择【持续集成】->【构建节点】中,点击右上角的【接入新节点】,选中 Linux,选择 Bash 接入方式。设置完成后在 Linux 环境中运行已生成的接入配置命令。如果希望使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。

手动接入

  1. 在【项目设置】->【开发者选项】->【项目令牌】里新建一个拥有「构建节点权限」的项目令牌。

  1. 进入构建节点,选择【接入新节点】->【Linux】,接入方式选择手动接入,选择对应客户端下载并放置在计算资源的自定义目录下。

  2. 选择对应节点池,如果要使用 Docker 运行构建节点,则勾选使用 Docker 运行构建节点。

  3. 如果已经建立好项目令牌,可以点击【一键生成并复制】,在放置客户端的目录下执行已复制的初始化命令。

  4. 执行已自动生成的客户端启动命令,让构建节点保持在线状态。

成功接入

成功接入并启动节点后,可以看到成功信息。如果节点配置小于推荐配置,系统会提示信息。

INFO[2020-06-17 14:39:39] Download tools.
Downloading jenkinsHome.zip ................................................................................................ Done
Downloading jenkins.war ............ Done
++++++++++++++++++++++++++++++++++++++++
----> Start agent
INFO[2020-06-17 14:43:11] 连接成功
WARN[2020-06-17 14:43:13] 当前节点配置小于 CODING 自定义构建节点的推荐配置要求

  配置项  当前配置  最小配置要求  推荐配置  
--------------------------------------------
  CPU     2 核      2 核          >= 4 核
  内存    8 GB      4 GB          >= 16 GB  
--------------------------------------------

INFO[2020-06-17 14:43:13] Success.

成功接入后,接入文件夹下可以看到 cci-agent。

agent1:agent user$ ls
cci-agent

在对应的节点池中也可以看到成功接入的节点处于闲置状态,表示可用于执行构建计划。

上一篇默认节点环境
最近更新
感谢反馈有用
感谢反馈没用

在阅读中是否遇到以下问题?

您希望我们如何改进?