升级自定义构建节点接入服务
升级背景
由于 CODING 持续集成旧版自定义节点接入服务存在稳定性不足等问题。为了提升您的使用体验，给您的团队提供更加优质的服务，我们针对此类问题进行了优化：将自定义节点接入服务由 cci-agent 全面升级为 qci_worker，提供更稳定的服务。
我们将于 2022 年 5 月 21 日下线旧版 cci-agent 接入服务，请您在此前根据下文指引，完成从旧版节点 cci-agent 升级到新版节点 qci_worker 的操作。如未在该日期前升级，使用自定义节点执行构建任务时可能会出现构建失败的情况。
新旧服务差异
| 服务名称 | 接入方式 | 稳定性 | 任务并发数 | 常用命令行 |
|---|---|---|---|---|
| cci-agent | 手动接入、Docker 接入 | 低 | 最多为 1 次 | 运行 cci-agent help 后查看 |
| qci_worker | 手动接入 | 高 | 最多为 50 次 | 文档详情 |
升级前提
在升级为 qci_worker 服务前，您需要在机器上提前安装下列依赖：
Python 3.6, Python 3.7, Python 3.8, Python 3.9
点击访问项目地址进行下载。
Git ≥ 2.8
点击访问项目地址进行下载。
Java 8, Java 11
点击访问项目地址进行下载。
Jenkins
jenkins.war 文件下载命令：
curl -fL "https://coding-public-generic.pkg.coding.net/cci/release/cci-agent/jenkins.war?version=2.293-cci" -o jenkins.warjenkins_home.zip 文件下载命令：
curl -fL "https://coding-public-generic.pkg.coding.net/cci/release/jenkinsHome.zip?version=latest" -o jenkins_home.zipWindows: 进入
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 文件。
升级操作
新版的节点接入服务将极大提升节点的稳定性，帮助您快速、有效地实现持续集成。请您根据下方操作指引，进行手动升级，以免旧节点下线后影响您和您的团队的使用。
请您在升级时，确保节点没有任务在执行，选择移除
cci-agent服务进程；同时请您确保当前机器的
cci-agent服务进程以及相关文件已删除，您可以使用以下命令进行检查并删除；
（1）ps -ef | grep cci-agent 检查进程是否存在，如果存在，则使用 “kill -9 进程 ID” 命令停用进程
（2）移除 ~/.coding 目录
- 如下图所示，请点击「接入新节点」，选择对应系统，复制接入命令执行即可完成升级。各个系统的不同安装方法详情请参考此文档。
常见问题
重启自定义节点服务后失败如何处理？
您需要参考上文将自定义节点接入服务升级为 qci_worker。
如果不升级服务会有什么影响？
如未在 2022 年 5 月 21 日之前升级为 qci_worker 服务，自定义构建节点将会无法执行构建任务。
接入 qci_worker 服务失败怎么办？
通常情况下接入 qci_worker 服务失败的原因由缺乏必备的依赖所引起。您可以查看错误日志，参考文档安装所需依赖重新进行接入。
成功接入后任务运行失败如何处理？
若您已成功接入 qci_worker 服务至团队构建节点池，但在运行持续集成任务后仍然提示失败，那么有可能是因为您的机器配置未能满足任务所需，造成任务堵塞等待超时后失败。您可以在节点池中下调节点的最大并发负荷数，降低任务负载。
有多台机器需要升级，如何进行批量升级？
目前暂不支持批量升级方式，您需要手动为每台机器执行升级操作，带来不便敬请谅解。
2022-05-09最近更新在阅读中是否遇到以下问题？*
您希望我们如何改进？*
如果您希望得到回复，请留下您的邮箱地址。
