Jenkins动态节点申请本质是任务驱动的自动Pod创建与回收，由Kubernetes插件作为调度开关实现：任务触发即拉起Pod，结束即释放资源。前提为插件（≥1.37）已安装且Jenkins能稳定访问集群，连接方式依部署位置分为内部ServiceAccount最小权限授权或外部kubeconfig配置；Pod模板需按需定制镜像、资源限制、多容器组合及挂载配置；整个流程由任务生命周期自动驱动，无需人工干预或HPA；可观测性依赖日志、Pod状态监控及常见失败原因排查。
Jenkins 动态节点申请本质是让构建任务驱动资源创建，而不是人先准备好机器再等任务来。Kubernetes 插件就是这个“调度开关”——任务一来，自动拉起 Pod；任务结束，立刻回收，全程无需人工干预。
核心前提：插件与集群连通
确保 Jenkins 已安装 Kubernetes 插件（版本 ≥ 1.37），且能稳定访问目标集群。连接方式取决于 Jenkins 部署位置：
- 若 Jenkins 运行在 K8s 内部，直接使用 ServiceAccount 绑定最小权限 Role（仅需 pods 的 create/list/delete/get）
- 若 Jenkins 在集群外部，需提供有效 kubeconfig 或 service account token，并配置可访问的 API Server 地址（通常通过 LoadBalancer 或 Ingress 暴露）
- 网络连通性必须验证：Jenkins 控制器要能调用
kubectl get pods -n <namespace>成功返回结果
Pod 模板定义：按需定制构建环境
每个动态节点对应一个 Pod 模板，它决定了构建时的运行环境。关键不是堆配置，而是聚焦实际需求：
- 镜像选择：优先复用已有的、带 Maven/Node.js/Golang 等工具链的镜像，避免在 Pod 启动时下载或安装（拖慢构建）
- 资源限制：为 CPU 和内存设置 request/limit，防止单个构建吃光节点资源；建议从 2C4G 起步，根据典型任务负载调整
- 容器组合：可在同一 Pod 中并行运行多个容器（如 jnlp + maven + selenium），实现“一次调度、多环境协同”，减少 Pod 创建频次
- 挂载配置：通过 volumeMount 挂载 Secret（如 Docker Hub 凭据）、ConfigMap（如 Maven settings.xml）或 PVC（如缓存目录），避免敏感信息硬编码
触发与回收：让扩容真正“按需”
动态节点不是靠定时轮询或手动触发，而是由 Jenkins 任务生命周期自动驱动：
- 当 Pipeline 或 Freestyle 任务被分配到 Kubernetes Cloud 时，插件立即按模板创建 Pod
- Pod 中的 JNLP 容器主动连接 Jenkins Master，注册为临时 agent；连接成功后开始执行构建步骤
- 构建成功或失败后，Pod 默认在 5 分钟内终止（可配置
idleMinutes）；若任务异常中断，插件也会在超时后清理残留 Pod - 无需额外配置 HPA —— Pod 数量天然跟随并发任务数伸缩，10 个任务同时排队就启 10 个 Pod，0 个任务就 0 个活跃 Pod
可观测与调优：避免“黑盒式”扩容
动态节点看不见摸不着，所以得靠日志和指标及时发现问题：
- 在 Jenkins 系统日志中搜索
KubernetesCloud关键字，确认 Pod 创建/删除事件是否正常 - 定期检查命名空间下 Pod 状态：
kubectl get pods -n jenkins-agents --watch，观察 pending、error、crashlooping 是否频繁出现 - 重点关注 Pod 启动失败原因：常见有镜像拉取失败（权限/网络）、资源不足（节点没空闲 CRI）、ServiceAccount 权限缺失（RBAC 报错）
- 对高频构建任务，可启用 Pod 缓存（
podRetention设为never外的选项），复用刚退出的 Pod 实例，降低冷启动开销
