在 Jenkins 声明式 Pipeline 中,可以使用 agent 指令来指定 Pipeline 运行在哪个 Jenkins agent 节点或 Docker 容器上。agent 可以用于整个 Pipeline,也可以应用于单个阶段。
以下是 agent 指令的一些常见用法:
agent any:将 Pipeline 分配到任何可用的节点上运行。agent none:不分配节点运行 Pipeline,需要使用其他方式来启动 Pipeline。agent { label 'my-label' }:将 Pipeline 分配到带有特定标签(label)的节点上运行。agent { docker 'my-image' }:在 Docker 容器中运行 Pipeline,可以指定 Docker 映像名称。agent { kubernetes { ... } }:在 Kubernetes 集群中运行 Pipeline,可以指定 Kubernetes Pod 和容器的配置。agent { node { ... } }:在其他类型的节点上运行 Pipeline,如 Windows 节点或者自定义节点。可以指定更多节点配置信息。
同时,也可以在阶段级别上使用 agent 来覆盖全局设置。例如,在 Pipeline 中的一个阶段中,可能需要在 Linux 节点上执行命令,而在另一个阶段中需要在 Windows 节点上执行命令。这时就可以使用阶段级别的 agent 来覆盖 Pipeline 级别的设置。
以下是一个具有两个阶段的示例,每个阶段都在不同的节点上执行:
pipeline {
agent any
stages {
stage('Build on Linux') {
agent {
label 'linux'
}
steps {
sh 'npm install'
sh 'npm run build'
}
}
stage('Test on Windows') {
agent {
label 'windows'
}
steps {
bat 'npm run test'
}
}
}
}
这个示例定义了两个阶段:Build on Linux 和 Test on Windows。在第一个阶段中,使用了 agent { label 'linux' } 来分配该阶段到带有标签“linux”的节点上运行。在第二个阶段中,使用了 agent { label 'windows' } 来分配该阶段到带有标签“windows”的节点上运行。
agent 指令非常灵活,并使得可以在多种不同的环境和配置中运行 Jenkins Pipeline。




