Jenkins：流水线结束时如何在主节点执行Python脚本

默认情况下，Jenkins流水线的post阶段会继承前面阶段的agent上下文，所以你之前的POST逻辑会继续在Kubernetes代理上运行。要强制在主节点执行脚本，有两种可靠的方式：

1. 在POST阶段显式指定主节点Agent #

在post块内部通过agent指令切换到主节点（需确保主节点的标签为master，或替换为你环境中主节点的实际标签）：

pipeline {
  agent {
    kubernetes {
      // 你的Kubernetes代理配置，例如Pod模板、容器镜像等
    }
  }
  stages {
    stage('K8s代理任务') {
      steps {
        sh 'echo "执行Kubernetes代理上的任务"'
      }
    }
  }
  post {
    always {
      agent { label 'master' }
      steps {
        // 在主节点执行Python脚本
        sh 'python3 /jenkins/scripts/cleanup.py'
        // 若使用Jenkins Python插件，也可直接调用python步骤
        // python {
        //   script '/jenkins/scripts/cleanup.py'
        // }
      }
    }
  }
}

2. 使用node('master')块包裹执行逻辑 #

通过node步骤直接切换到主节点上下文，无需修改POST阶段的agent配置：

pipeline {
  agent {
    kubernetes {
      // Kubernetes代理配置
    }
  }
  stages {
    stage('K8s代理任务') {
      steps {
        sh 'echo "执行Kubernetes代理上的任务"'
      }
    }
  }
  post {
    always {
      script {
        node('master') {
          // 主节点上执行Python脚本
          sh 'python3 /jenkins/scripts/cleanup.py'
        }
      }
    }
  }
}

关键注意事项 #

• 核对主节点的标签：部分环境可能用jenkins-master而非默认的master，需在Jenkins「管理节点」页面确认主节点的标签设置
• 主节点环境准备：确保主节点已安装对应版本的Python，且脚本路径在主节点上可访问（可放在主节点本地目录或共享存储）
• 主节点执行权限：若主节点设置为0个执行器，需进入主节点配置页面修改执行器数量，允许其运行任务

内容的提问来源于stack exchange，提问作者Jean-Michel Rousseau