Problem Statement On a Jenkins master with global definition of a Shared Library named shared-library, And the following files in a repository: Jenkinsfile
node {
stage( "setup" ) {
checkout scm
}
stage( "pipeline" ) {
load( "Pipeline.groovy" ).run_pipeline()
}
}
Pipeline.groovy
@Library( 'shared-library@master' )
def run_pipeline() {
someMethodFromSharedLibrary()
}
return this
Where someMethodFromSharedLibrary() is a Global Variable in the vars/someMethodFromSharedLibrary.groovy file in the shared library, The pipeline errors on the load(...) step of the Jenkinsfile with a "no definition of libraries found" error:
ERROR: Could not find any definition of libraries [shared-library@master]
Analysis This is because of the algorithm in LibraryAdder here:
LibrariesAction action = build.getAction(LibrariesAction.class);
if (action != null) {
– https://github.com/jenkinsci/workflow-cps-global-lib-plugin/blob/f371b987a3e79928962043f18a5d95aef7397b76/src/main/java/org/jenkinsci/plugins/workflow/libs/LibraryAdder.java#L88-L89
After the main Jenkinsfile script is processed, a LibrariesAction is added to the build with no library definitions. When the new script Pipeline.groovy is processed during load(..), it sees the action from the previous script and uses the empty set of library definitions to match against actual library requests that are correctly detected in the @Library annotation in the load()'d script. This causes the "no definition for libraries" error message. The library definitions in the load()'d script are never considered. |
