升级自定义构建节点接入服务
升级背景
由于 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.war
jenkins_home.zip 文件下载命令:
curl -fL "https://coding-public-generic.pkg.coding.net/cci/release/jenkinsHome.zip?version=latest" -o jenkins_home.zip
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 文件。
升级操作
新版的节点接入服务将极大提升节点的稳定性,帮助您快速、有效地实现持续集成。请您根据下方操作指引,进行手动升级,以免旧节点下线后影响您和您的团队的使用。
请您在升级时,确保节点没有任务在执行,选择移除
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 服务至团队构建节点池,但在运行持续集成任务后仍然提示失败,那么有可能是因为您的机器配置未能满足任务所需,造成任务堵塞等待超时后失败。您可以在节点池中下调节点的最大并发负荷数,降低任务负载。
有多台机器需要升级,如何进行批量升级?
目前暂不支持批量升级方式,您需要手动为每台机器执行升级操作,带来不便敬请谅解。
在阅读中是否遇到以下问题?*
您希望我们如何改进?*
如果您希望得到回复,请留下您的邮箱地址。