scripted-vs-declarative-pipeline.md

Scripted vs declarative pipeline

Due an historical reason is not possible to use exact same syntax in the declarative and scripted pipeline. In declarative pipeline you must so far set resource : null.

Declarative

pipeline {
    agent any

    stages {
        stage("Build") {
            steps {
                lock(label: 'printer', quantity: 1, resource : null) {
                    echo 'printer locked'
                }
            }
        }
    }
}

Scripted

node() {
    stage("Build") {
        lock(label: 'printer', quantity: 1) {
            echo 'printer locked'
        }
    }
}

Pitfalls

Setting quantity to null, 0 or a smaller number, all available resources of that label are locked at once. See #198 - Lock All resources by setting quantity to 0 is not documented.