jenkins-01Jenkins 架构与任务调度

概念

1、agent

agent实际执行所分配的构建任务如代码推送、测试、编译、打包、部署。不同的agent可以进行任务区分如java环境,前端环境

2、executor

规定agent节点可以同时执行的任务数量,可以根据系统资源调整executor的个数,完成系统的任务执行

3、label

给节点打标签可用于分组,调用的时候更方便

场景

任务调度异常:Job 一直处于排队状态

1. 故障现象

多个构建任务需要执行,但部分任务一直处于 Queue 状态,没有分配到 Agent。

2. 原因分析
  • 没有符合 Label 要求的 Agent。

  • 符合条件的 Agent 已经没有空闲 Executor。

  • Agent 处于 Offline 状态。

  • Job 或 Pipeline 存在其他节点调度限制。

  • 任务受到并发限制或资源锁限制。

3. 排查思路

第一步:检查 Label 是否匹配

确认 Job 或 Jenkinsfile 指定的 Label,以及 Agent 实际配置的 Label。

第二步:检查 Agent 状态

确认符合条件的 Agent 是否在线、是否可以接收任务。

第三步:检查 Executor 使用情况

确认节点的 Executor 是否已经被其他任务占用。

第四步:检查其他调度限制

检查并发构建限制、Pipeline 配置以及资源锁等因素。

Agent 节点 Offline 故障排查

1. 故障现象

Agent 原本可以正常执行构建任务,突然变成 Offline,导致任务无法调度到该节点。

2. 原因分析
  • Controller 与 Agent 之间网络通信异常。

  • Agent 服务器上的 Java 进程异常退出。

  • SSH 认证失败。

  • Java 版本不满足 Jenkins Agent 的运行要求。

  • Agent Remoting 通信异常。

  • Agent 服务器资源不足。

3. 排查思路

第一步:检查网络通信

确认 Controller 与 Agent 之间的网络和必要通信端口是否正常。

复制代码
ping <agent_ip>
nc -zv <agent_ip> <port>

注意:SSH 方式通常需要检查 22 端口;Inbound Agent 则需要根据实际配置检查对应通信方式和端口。

第二步:检查服务和进程状态

Controller:

复制代码
systemctl status jenkins
journalctl -u jenkins -n 100

Agent:

复制代码
ps -ef | grep java

第三步:检查 Java 环境

复制代码
java -version
which java
echo $JAVA_HOME

确认 Java 版本是否满足当前 Jenkins Agent Remoting 的运行要求。

第四步:检查 SSH 认证

复制代码
ssh -v user@agent_ip

检查密钥、用户权限、认证配置是否正常。

第五步:查看 Jenkins 系统日志

重点关注 Agent 断开时间附近的日志,分析连接失败、认证失败、进程退出或 Remoting 异常等信息。

故障排查原则

Jenkins 故障排查不能只依赖某一个命令,需要结合故障现象、日志和实际运行状态逐步缩小范围。

建议按照以下顺序:

  1. 确定故障范围:单个 Job、多个 Job,还是整个 Agent。

  2. 检查 Jenkins 节点状态和任务调度情况。

  3. 检查网络、进程、运行环境和权限。

  4. 查看日志,定位具体异常。

  5. 修复后重新执行任务,验证是否恢复。

进度

  • 已理解:Agent、Executor、Label 的关系。

  • 已掌握基本排查思路:任务排队、Agent Offline。

  • 待实践:SSH Agent 连接、Remoting 日志分析、真实故障恢复。

相关推荐
tianyuanwo14 小时前
PostgreSQL 部署运维实战总结:从安装踩坑到生产可用
运维·数据库·postgresql
Decay__14 小时前
SQLServer 优化案例集 —— 慢 SQL 优化、索引重构与参数调整收益对比
运维·数据库·sql·mysql·架构
优化Henry16 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd
manageengine16 小时前
服务器 CPU 100% 怎么排查:8 条命令从现象定位到根因
运维·服务器·cpu
分布式存储与RustFS16 小时前
RustFS 分片上传怎么配:大文件断点续传的最小可验证流程
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
爱吃香菜的初学者17 小时前
二十五.Linux——epoll
linux·运维·服务器
宽海智能仓储物流18 小时前
宽海智能WCS系统常见问题全解析:从选型对接、运维定制到降本增效
运维·数据仓库·自动化
无奈笑天下19 小时前
银河麒麟上DHCP无法获取IP地址问题处理
linux·运维·服务器·网络协议
分布式存储与RustFS19 小时前
Rivet 的 Agent 状态存进自建 RustFS:主桶配置与上线边界
运维·云原生·开源·对象存储·分布式存储·s3·性能基准