注意：说明：
注意：由于安全合规原因，自2025年01月01日起我们已不再支持新增自定义构建节点的接入。现有自定义构建节点仍然可以继续正常运行。详情可 查看公告。
这里说明如何使用自定义节点。
一、进入项目
1. 登录 CODING 控制台，单击团队域名进入 CODING 使用页面。
2. 进入目标项目后，选择左侧导航栏的持续集成。
二、功能介绍
在实际的开发项目中，所涉及的开发环境可能是多种多样的。当默认节点的构建环境无法承载项目的运行要求时，例如需使用 macOS Xcode 构建 iOS 应用，那么就可以通过接入自定义类型节点（物理机/虚拟机/容器等）运行特定任务。
接入构建节点时需指定接入的构建节点池，构建节点不能游离节点池而单独存在。构建节点池 分为团队与项目两种类型。
注意：使用自定义节点相当于将你的构建机纳入 CODING 的管控范围。为了保障你的机器和内网的安全，请务必妥善保管你的用户名和密码，并建议开启登录二次认证。在必要时，你还需要制定构建机内网的安全策略，以确保你的机器和内网不受到未经授权的访问和攻击。
三、接入节点
接入自定义节点的过程本质上是在节点中运行 Worker 服务，单击了解 Worker 常用命令。
目前支持 macOS、Windows、Linux 环境接入至构建计划节点池。
四、推荐配置
·CPU 8 核或以上。
·内存 16 GB 或以上。
五、环境依赖
·Python 3.6, Python 3.7, Python 3.8, Python 3.9
单击访问 项目地址 进行下载。
·Git ≥ 2.8
单击访问 项目地址 进行下载。
·Java 8, Java 11
单击访问 项目地址 进行下载。
·Jenkins
Windows：进入 C:/ 目录，创建 codingci/tools 目录。在其中下载 jenkins.war 、jenkins_home.zip 文件，并在 tools/ 目录解压 jenkins_home.zip 文件。
Linux：进入 /root/ 目录，创建 codingci/tools 目录。在其中下载 jenkins.war 、jenkins_home.zip 文件，并在 tools/ 目录解压 jenkins_home.zip 文件。
macOS：进入 ~/ 目录，创建 codingci/tools 目录。在其中下载 jenkins.war 、jenkins_home.zip 文件，并在 tools/ 目录解压 jenkins_home.zip 文件。
注意：说明：
注意：预装以上环境是接入自定义节点时的先决条件。接入后若要确保构建计划正常运行，仍需视任务或插件的实际需求预装不同的环境，你可以参见 默认节点环境 安装常见的 SDK 与命令行工具。
六、命令接入
1. 进入构建节点，选择接入新节点 > macOS，接入方式选择 Bash，在接入配置中选择对应节点池，单击生成接入配置并复制。
2. 在终端中输入命令后，等待服务下载完成。安装完成后可以使用以下命令进行验证：
qci_worker version
命令接入的默认安装目录为 /root/codingci。
七、手动接入
使用手动接入方式前请确保节点 已满足上文中的 环境依赖 要求。
1. 接入方式选择手动接入，按照提示在终端中输入命令安装客户端，即安装 Worker 服务。
2. 选择拟接入的节点池，单击一键生成并复制，生成初始化命令。
3. 在终端中执行已自动生成的客户端启动命令，让构建节点保持在线状态。
八、命令接入
1. 选择持续集成 > 构建节点中，单击右上角的接入新节点，选中 Windows，选择 Powershell 接入方式。
2. 安装完成后可以使用以下命令进行验证：
qci_worker version
命令接入的默认安装目录为 /root/codingci。
九、手动接入
使用手动接入方式前请确保节点 已满足上文中的 环境依赖 要求。
1. 接入方式选择手动接入，按照提示在终端中输入命令安装客户端，即安装 Worker 服务。
2. 选择拟接入的节点池，单击一键生成并复制，生成初始化命令。
3. 在终端中执行已自动生成的客户端启动命令，让构建节点保持在线状态。
十、命令接入
1. 选择持续集成 > 构建节点中，单击右上角的接入新节点，选中 Linux，选择 Bash 接入方式。设置完成后在 Linux 环境中运行已生成的接入配置命令。
2. 安装完成后可以使用以下命令进行验证：
qci_worker version
命令接入的默认安装目录为 /root/codingci。
十一、手动接入
使用手动接入方式前请确保节点 已满足上文中的 环境依赖 要求。
1. 接入方式选择手动接入，按照提示在终端中输入命令安装客户端，即安装 Worker 服务。
2. 选择拟接入的节点池，单击一键生成并复制，生成初始化命令。
3. 在终端中执行已自动生成的客户端启动命令，让构建节点保持在线状态。
十二、启动守护进程
安装完成后，在构建节点上需要运行守护进程，用以监听并获取由 CODING 后台下发的 CI 任务。以下为运行 / 删除命令行：
# 在后台运行qci_worker up -d # 在前台运行qci_worker up # 暂时停止运行qci_worker stop