Working with versions on Jenkins Pipeline Shared Libraries

jenkins groovy shared-libraries jenkins-pipeline multiple-versions
Cristian Gonçalves picture Cristian Gonçalves · Jan 19, 2017 · Viewed 7.2k times · Source

I'm trying to figure it out on how to work with a specific version of a Shared Library.

Jenkins documentation about this isn't quite clear so I've being making some experimenting but with no success.

They basically say:

enter image description here

But how should I configure somelib on 'Global Pipeline Libraries' section under Manage Jenkins > System Config menu so I can use any of the available stable versions?!

The thing is: Imagine that I've my somelib Project under version control and, currently, I've released 2 stable versions of it: v0.1 and v0.2 (so I have 2 tags named v0.1 and v0.2).

And in some Pipeline I want to use somelib's version v0.1 and on another Pipeline I need to use v0.2 version.

How can I do this using the @Library annotation provided by Jenkins?

Answer

fishi0x01 picture fishi0x01 · Jan 19, 2017

In the Global Pipeline Libraries under Jenkins > System Config you only set the default library version to use if not specified otherwise inside the Jenkinsfile. This might look like this (ignore the Failed to connect to repo error here):

enter image description here

Inside the Jenkinsfile you can explicitly specify which version you want to use if you do not want the default:

@Library('somelib@<tag/branch/commitRef>')

That way you can freely choose at any time which pipeline version to use for you project.

Related questions

Load Jenkins Pipeline Shared Library from same repository

TL;DR Is there a way to import code into the Jenkinsfile from the local repository (other than the load step)? Why? I've experienced that for complex builds the Jenkinsfile gets kind of bulky and not very maintainable. Now that …

Read More
How can I trigger another job from a jenkins pipeline (jenkinsfile) with GitHub Org Plugin?

How can I trigger build of another job from inside the Jenkinsfile? I assume that this job is another repository under the same github organization, one that already has its own Jenkins file. I also want to do this only …

Read More
Jenkins: Cannot define variable in pipeline stage

I'm trying to create a declarative Jenkins pipeline script but having issues with simple variable declaration. Here is my script: pipeline { agent none stages { stage("first") { def foo = "foo" // fails with "WorkflowScript: 5: Expected a step @ line 5, column 13." sh "echo ${foo}" } } } …

Read More