Skip links

How to Improve Your Jenkins Builds with Shared Libraries

Jump To Section

What is a Shared Library?

A shared library in Jenkins is a reusable collection of Groovy scripts that can be used by multiple Jenkins jobs. This allows you to share code and functionality between different jobs, which can make your builds more efficient and easier to maintain.

To understand the concept of shared libraries, let’s consider a real-time example. Imagine you have multiple Jenkins pipelines that require a common set of functions for interacting with a version control system, such as Git. Instead of duplicating the Git-related code in each pipeline, you can create a shared library that encapsulates the necessary Git operations.

Folder Structure of Shared Library

Folder Structure Used in Shared Library
  1. The src directory is structured like a standard Java project. This means that you can use the import statement to import classes from other directories in the src directory.
  2. The vars directory is a special directory that contains global variables that are defined in the shared library. These variables can be accessed from any Jenkins job that imports the shared library.
  3. The resources directory is a regular directory that can contain any type of file. However, it is typically used to store static resources that are used by the shared library.

Steps to Configure Shared Library in Jenkins

Create a repository in any source code management tool.

Here we are using GitHub.

Clone the newly created repository

git clone https://github.com/tejashreeSalvi/shared-lib.git

Create a folder structure

cd shared-lib
# create a master branch (optional)
git branch master
git checkout master
# create vars directory
mkdir vars
cd vars

We have created the vars directory in which we are going to write our reusable function.

Let’s consider a real-time example. Imagine you have multiple Jenkins pipelines that require a common set of functions for interacting with a version control system, such as Git. Instead of duplicating the Git-related code in each pipeline, you can create a shared library that encapsulates the necessary Git operations.

Creating your First Shared Library to checkout scm.

checkoutCode.groovy

def call(String repoUrl, String branch){
def workingDir = "${env.WORKSPACE}"
sh "git clone ${repoUrl} ${workingDir}"
sh "git checkout ${branch}"
return workingDir
}
  1. The call method, which is a special method in Jenkins shared library that allows the function to be directly called from a Jenkins pipeline.
  2. ${env.WORKSPACE} assigns the Jenkins environment variable WORKSPACE
  3. sh is used to execute a shell command to clone the repository in the workingDir and checkout(switch) to the specified branch .
  4. the path workingDir is returned to Jenkins Pipeline.

This piece of functionality can be reused in Jenkins pipelines that import and use the shared library.

Commit your changes to a Git repository.

git add .
git commit -m "checkout scm fucntionality added"
git push origin master

The code is successfully pushed and available in the remote repository.

Configure the Global pipeline Libraries (Shared Library) in Jenkins

Login to Jenkins.

Go to Manage Jenkins → Configure System

Next Step, Search for Global Pipeline Libraries and configure the parameters.

  1. Enter the Shared Library Name: shared-lib
  2. Set the default branch: master (Jenkins will consider the default branch if no branch is specified while importing shared lib).

3. Configure the repository we created for Shared Library: https://github.com/tejashreeSalvi/shared-lib.git

GitHub – tejashreeSalvi/shared-lib: Jenkins shared library

4. Configure the credentials, if your repository is private

5. Click Save

WoW! we are done with configuration part.

Let’s use the shared library in pipelines

To Import the library we use the @Library annotation and specify the library name defined in the Jenkins Global Configuration.

Create a Jenkins pipeline

Go to New Item and give a suitable pipeline name first-shared-lib-pipeline and Type pipeline

Click on OK

Script to Import the Shared Library

Go to Pipeline Script→ Add the Script and Save@Library(“shared-lib@master”) _

pipeline {
agent any
stages {
stage('Code Checkout') {
steps {
script {
def workingDir = checkoutCode("https://github.com/tejashreeSalvi/django-todo-cicd.git", "develop")
echo $workingDir
}
}
}
}
}
  1. @Library("shared-lib@master") _: this will import the shared library named “shared-lib” at the “master” branch. The library is made available for use in this Jenkins pipeline.

2. def workingDir = checkoutCode("https://github.com/tejashreeSalvi/django-todo-cicd.git", "develop"): This line calls the checkoutCode function from the shared library, passing the repository URL and Branch name.

Hence you can create multiple pipelines and use the checkoutCode function from a shared library to checkout scm. Instead of writing the block of code again and again in all the Jenkins pipelines.

Build the Pipeline.

Go to first-shared-lib-pipeline → Click on Build Now

The build will be triggered. Check the console output of the build.

If you look closely, you will find that the Shared library was loaded successfully.

By using the shared library and calling the checkoutCode function, this pipeline script performs a code checkout operation by cloning the specified repository and switching to the develop branch.

Hurray! We have created our first reusable code using Shared Library.

When to use and When to not use Shared Library.

That’s it! We have learned basics about Shared Library. Hope you will use it in your next project.

Pre-requisites

Install Jenkins

Tejashree Salvi

Tejashree Salvi

Latest Reads

Subscribe

Suggested Reading

Ready to Unlock Yours Enterprise's Full Potential?

Adaptive Clinical Trial Designs: Modify trials based on interim results for faster identification of effective drugs.Identify effective drugs faster with data analytics and machine learning algorithms to analyze interim trial results and modify.
Real-World Evidence (RWE) Integration: Supplement trial data with real-world insights for drug effectiveness and safety.Supplement trial data with real-world insights for drug effectiveness and safety.
Biomarker Identification and Validation: Validate biomarkers predicting treatment response for targeted therapies.Utilize bioinformatics and computational biology to validate biomarkers predicting treatment response for targeted therapies.
Collaborative Clinical Research Networks: Establish networks for better patient recruitment and data sharing.Leverage cloud-based platforms and collaborative software to establish networks for better patient recruitment and data sharing.
Master Protocols and Basket Trials: Evaluate multiple drugs in one trial for efficient drug development.Implement electronic data capture systems and digital platforms to efficiently manage and evaluate multiple drugs or drug combinations within a single trial, enabling more streamlined drug development
Remote and Decentralized Trials: Embrace virtual trials for broader patient participation.Embrace telemedicine, virtual monitoring, and digital health tools to conduct remote and decentralized trials, allowing patients to participate from home and reducing the need for frequent in-person visits
Patient-Centric Trials: Design trials with patient needs in mind for better recruitment and retention.Develop patient-centric mobile apps and web portals that provide trial information, virtual support groups, and patient-reported outcome tracking to enhance patient engagement, recruitment, and retention
Regulatory Engagement and Expedited Review Pathways: Engage regulators early for faster approvals.Utilize digital communication tools to engage regulatory agencies early in the drug development process, enabling faster feedback and exploration of expedited review pathways for accelerated approvals
Companion Diagnostics Development: Develop diagnostics for targeted recruitment and personalized treatment.Implement bioinformatics and genomics technologies to develop companion diagnostics that can identify patient subpopulations likely to benefit from the drug, aiding in targeted recruitment and personalized treatment
Data Standardization and Interoperability: Ensure seamless data exchange among research sites.Utilize interoperable electronic health record systems and health data standards to ensure seamless data exchange among different research sites, promoting efficient data aggregation and analysis
Use of AI and Predictive Analytics: Apply AI for drug candidate identification and data analysis.Leverage AI algorithms and predictive analytics to analyze large datasets, identify potential drug candidates, optimize trial designs, and predict treatment outcomes, accelerating the drug development process
R&D Investments: Improve the drug or expand indicationsUtilize computational modelling and simulation techniques to accelerate drug discovery and optimize drug development processes