如何在运行Jenkins job前检查对应slave节点是否存在

可以在Jenkins任务正式启动执行前完成绑定节点的存在性、可用性校验，避免无效任务堆积在队列中，以下是两种适配不同任务类型的落地方式：

方案1：适配自由风格任务 #

• 进入目标任务的配置页，找到「构建」模块，点击「增加构建步骤」，选择「执行系统Groovy脚本」
• 将该步骤拖动到所有构建步骤的最前面，粘贴如下校验脚本：

// 替换为你的任务绑定的节点名或节点标签
def targetNodeInfo = "your-node-name-or-label"
def hasAvailableNode = Jenkins.instance.nodes.any { node ->
    // 同时校验节点存在、且处于在线可用状态
    (node.name == targetNodeInfo || node.labelString.contains(targetNodeInfo)) 
    && node.toComputer() != null 
    && node.toComputer().isOnline()
}
if (!hasAvailableNode) {
    println "校验不通过：绑定的节点/标签 ${targetNodeInfo} 无可用在线节点，任务终止"
    throw new InterruptedException("无可用执行节点")
}

• 保存配置即可，后续任务触发后会先执行该校验，校验不通过会直接终止，不会进入后续执行逻辑。

方案2：适配Pipeline流水线任务 #

直接在流水线的最开头新增节点校验阶段，示例配置如下：

pipeline {
    // 校验阶段用任意可用节点执行即可
    agent any
    stages {
        stage('节点可用性校验') {
            steps {
                script {
                    // 替换为你的任务绑定的节点名或标签
                    def targetNodeInfo = "your-node-name-or-label"
                    def hasAvailableNode = Jenkins.instance.nodes.any { node ->
                        (node.name == targetNodeInfo || node.labelString.contains(targetNodeInfo)) 
                        && node.toComputer() != null 
                        && node.toComputer().isOnline()
                    }
                    if (!hasAvailableNode) {
                        // 校验不通过直接终止流水线
                        error "指定节点/标签${targetNodeInfo}不存在或未在线，任务终止"
                    }
                }
            }
        }
        // 后续为原有任务的执行逻辑
        stage('正式执行业务逻辑') {
            agent { label 'your-node-name-or-label' }
            steps {
                echo "任务正常执行"
                // 这里写你原来的任务步骤
            }
        }
    }
}

注意：如果你的Jenkins开启了脚本安全校验，需要在「管理Jenkins」-「进程内脚本批准」中把上述脚本用到的相关方法加入批准列表，避免脚本执行报错。

内容的提问来源于stack exchange，提问作者Mohamed Khamis