常见问题
自定义构建节点配额
- 接入的自定义节点不会受到 CODING 团队配额限制；
- 自定义构建节点不计入团队每周构建次数配额限制；
- 自定义构建节点不受团队并行上限配额限制；
- 自定义构建节点不受超时配额限制；
自定义构建节点的缓存
配置了自定义构建节点池的构建计划将使用构建节点自身的缓存。
使用自定义构建节点执行的构建计划，在每次执行的时候会创建一个独立的 WorkSpace，构建结束后会将其清理。构建过程中产生在工作空间外的文件将会保留（如 maven / npm 等制品库的全局缓存）。
重复注册 cci-agent 并作为多个构建节点
默认的情况下，如果在一台机器上重复注册 cci-agent 会提示节点已被注册，并且需要删除注册节点后才能重新注册。
这是因为注册节点需要提供 config 目录（默认为 ～/.config）和端口号（默认为 15740），您只需要手动指定不冲突的 config 目录和端口号即可重复注册节点。
在进行操作之前，请确保您已经在【项目设置】->【开发者选项】->【项目令牌】申请了具备构建节点权限的项目令牌密码。
下面为使用 ~/.coding2 和 15741 端口进行重复注册的示例操作。
./cci-agent init --config ~/.coding2 --pt <项目令牌密码>./cci-agent up --config ~/.coding2 --jport 15741异常状态处理方式
在实际生产中，接入自定义构建节点可能会存在如客户端的网络环境，配置环境缺失等诸多不稳定因素，下面将罗列出已知异常状态的处理方式。
删除构建节点池
| 相关位置 | 构建记录错误提示 | 处理方式 |
|---|---|---|
| 配置构建计划 | - | 构建计划节点池配置中不会出现已经被删除的构建节点池 |
| 已配置构建计划 | 配置页面上会提示构建节点池已被删除 | 在构建计划中已配置的构建节点池被删除，需要用户手动重新配置 |
| 触发构建任务 | 该构建计划配置的构建节点池 my-pool 已被删除，请重新配置 | 允许触发，但构建任务会立即失败 |
| 队列中、初始化、准备构建、构建中 | 该构建计划配置的构建节点池 my-pool 已被删除，请重新配置 | 这几种状态的构建任务会立即失败 |
删除处于”占用”状态的构建节点
| 相关位置 | 构建记录错误提示 | 处理方式 |
|---|---|---|
| 队列中的构建任务 | - | 不受到影响，队列中的构建任务尚未分配具体的构建节点，在寻找到有效构建节点之前会一直处于队列中的状态 |
| 初始化、准备构建、构建中 | 构建节点 xxx 已离线 | 这几种状态的构建任务会立即失败 |
处于“占用”状态的构建节点掉线
由于客户端网络环境不稳定，构建节点可能会存在掉线的情况
掉线后客户端（构建节点）会尝试进行重试，服务端会尝试等待客户端重新连接
- 等待超时（ 3 分钟）则会判断构建节点离线，并将构建任务标记为失败
- 若重连成功，客户端将继续上报构建的内容
| 相关位置 | 构建记录错误提示 | 处理方式 |
|---|---|---|
| 队列中的构建任务 | - | 不受到影响，队列中的构建任务尚未分配具体的构建节点，在寻找到有效构建节点之前会一直处于队列中的状态 |
| 初始化、准备构建、构建中 | 构建节点 xxx 已离线 | 这几种状态的构建任务会立即失败 |
配置的构建节点池没有接入节点
| 相关位置 | 构建记录错误提示 | 处理方式 |
|---|---|---|
| 配置构建计划 | - | 因为构建计划并不会直接关联构建节点，所以不影响构建计划对配置，若节点池内不存在构建节点 ，配置页面中会给出相应的警告。 |
| 已配置构建计划 | - | 因为构建计划并不会直接关联构建节点，所以不影响构建计划对配置，若节点池内不存在构建节点 ，配置页面中会给出相应的警告。 |
| 初始化、准备构建、构建中 | 该构建计划配置的构建节点池 my-pool 已被删除，请重新配置 | 这几种状态的构建任务会立即失败 |
取消构建计划授权
| 相关位置 | 构建记录错误提示 | 处理方式 |
|---|---|---|
| 配置构建计划 | 会给出相对应的提示信息 | 不允许用户选中未授权的构建计划 |
| 已配置构建计划 | - | 构建记录列表页面和构建配置页面会给出未授权的提示信息，用户需要手动调整节点池配置 |
| 触发构建任务 | 该构建计划没有获得构建节点池 default 的授权，请授权 | 允许触发，但构建任务会立即失败 |
| 初始化、准备构建、构建中 | 该构建计划配置的构建节点池 my-pool 已被删除，请重新配置 | 这几种状态的构建任务会立即失败 |
自定义节点异常问题收集
自定义节点操作系统为最小化安装的 CentOS
如果您的自定义节点 Jenkins 无法启动，如下情况报 Warning 时，可能是由于节点的操作系统为最小化安装的 CentOS (Minimal Install)，而 Jenkins 的网页页面依赖一些图形化组件。
解决方案为执行一下命令：
yum install fontconfig
最近更新感谢反馈有用
感谢反馈没用