Can I define multiple agent labels in a declarative Jenkins Pipeline?

Question

I'm using declarative Jenkins pipelines to run some of my build pipelines and was wondering if it is possible to define multiple agent labels.

I have a number of build agents hooked up to my Jenkins and would like for this specific pipeline to be able to be built by various agents that have different labels (but not by ALL agents).

To be more concrete, let's say I have 2 agents with a label 'small', 4 with label 'medium' and 6 with label 'large'. Now I have a pipeline that is very resource-low and I want it to be executed on only a 'small'- or 'medium'-sized agent, but not on a large one as it may cause larger builds to wait in the queue for an unnecessarily long time.

All the examples I've seen so far only use one single label. I tried something like this:

 agent { label 'small, medium' } 

But it failed.

I'm using version 2.5 of the Jenkins Pipeline Plugin.

Answer 1

You can see the 'Pipeline-syntax' help within your Jenkins installation and see the sample step "node" reference.

You can use exprA||exprB:

node('small||medium') {     // some block } 

Answer 2

EDIT: I misunderstood the question. This answer is only if you know which specific agent you want to run for each stage.

If you need multiple agents you can declare agent none and then declare the agent at each stage.

https://jenkins.io/doc/book/pipeline/jenkinsfile/#using-multiple-agents

From the docs:

pipeline {     agent none     stages {         stage('Build') {             agent any             steps {                 checkout scm                 sh 'make'                 stash includes: '**/target/*.jar', name: 'app'              }         }         stage('Test on Linux') {             agent {                  label 'linux'             }             steps {                 unstash 'app'                  sh 'make check'             }             post {                 always {                     junit '**/target/*.xml'                 }             }         }         stage('Test on Windows') {             agent {                 label 'windows'             }             steps {                 unstash 'app'                 bat 'make check'              }             post {                 always {                     junit '**/target/*.xml'                 }             }         }     } }