Why shared libraries reduce duplication in Jenkins - See It in Action

Why Shared Libraries Reduce Duplication in Jenkins

📖 Scenario: You work in a team that uses Jenkins to automate software builds and tests. Many Jenkins pipelines have similar steps like checking out code, running tests, and sending notifications. To avoid repeating the same code in every pipeline, your team wants to use Jenkins shared libraries.

🎯 Goal: Build a simple Jenkins shared library and use it in a pipeline to reduce code duplication. You will create a shared library function and call it from a Jenkinsfile.

📋 What You'll Learn

Create a shared library function named greet that prints a welcome message

Create a Jenkinsfile that calls the greet function from the shared library

Show how using the shared library avoids repeating the greeting code in multiple pipelines

💡 Why This Matters

🌍 Real World

Teams use Jenkins shared libraries to keep their pipeline code clean and avoid repeating the same steps in many places.

💼 Career

Knowing how to create and use Jenkins shared libraries is a valuable skill for DevOps engineers to build scalable and maintainable CI/CD pipelines.

1

Create the shared library function

Create a Groovy script file named vars/greet.groovy with a function called call that prints the message "Hello from shared library!".

Jenkins

// Create vars/greet.groovy with a call() function that prints the greeting
// Your code here

Hint

Use def call() to define the function and echo to print the message.

2

Create a Jenkinsfile that uses the shared library

Create a Jenkinsfile that calls the shared library function greet() inside a pipeline block with a stage named Greeting.

Jenkins

// Create a Jenkinsfile that calls greet() inside a pipeline stage
// Your code here

Hint

Use pipeline and stage blocks, then call greet() inside steps.

3

Explain how shared libraries reduce duplication

Add a comment in the Jenkinsfile explaining that using the shared library function greet() avoids repeating the greeting code in multiple pipelines.

Jenkins

// Add a comment explaining how shared libraries reduce duplication
// Your code here

Hint

Write a comment starting with // that says the greeting code is written once and reused.

4

Run the Jenkins pipeline and see the output

Run the Jenkins pipeline and write the exact output line that shows the greeting message from the shared library.

Jenkins

// Write the exact output line from the pipeline run below
// Your code here

Hint

Look for the echo output line in the Jenkins pipeline logs.

Practice

1. Why do Jenkins shared libraries help reduce duplication in pipelines?

easy

A. They let you reuse common code across multiple pipelines.

B. They automatically fix errors in your pipeline scripts.

C. They run pipelines faster by caching results.

D. They replace the need for Jenkins agents.

Solution

1. Step 1: Understand what duplication means in Jenkins pipelines

   Duplication means copying the same code in many pipeline scripts, which wastes time and can cause errors.

2. Step 2: Identify how shared libraries help

   Shared libraries store common code in one place, so pipelines can reuse it without copying.

3. Final Answer:

   They let you reuse common code across multiple pipelines. -> Option A

4. Quick Check:

   Reuse code = reduce duplication [OK]

Hint: Shared libraries store reusable code to avoid copy-paste [OK]

Common Mistakes:

• Thinking shared libraries fix errors automatically
• Believing they speed up pipeline execution
• Confusing shared libraries with Jenkins agents

2. Which is the correct syntax to load a shared library in a Jenkins pipeline script?

easy

A. import sharedLib from 'my-shared-lib'

B. loadLibrary('my-shared-lib')

C. library 'my-shared-lib'

D. @SharedLibrary('my-shared-lib')

Solution

1. Step 1: Recall Jenkins syntax for loading shared libraries

   Jenkins uses the library 'name' step to load shared libraries in pipeline scripts.

2. Step 2: Compare options to correct syntax

   Only library 'my-shared-lib' matches the official syntax; others are incorrect or invalid.

3. Final Answer:

   library 'my-shared-lib' -> Option C

4. Quick Check:

   library 'name' loads shared library [OK]

Hint: Use library 'name' to load shared libraries [OK]

Common Mistakes:

• Using loadLibrary() which is not a Jenkins step
• Confusing annotation syntax with @Library
• Trying to import like a programming language

3. Given this Jenkins pipeline snippet using a shared library:

library 'utils'

pipeline {
  agent any
  stages {
    stage('Test') {
      steps {
        script {
          def result = utils.calculateSum(2, 3)
          echo "Sum is ${result}"
        }
      }
    }
  }
}

What will be the output if calculateSum returns the sum of two numbers?

medium

A. Sum is 5

B. Sum is 23

C. Sum is utils.calculateSum(2, 3)

D. Error: calculateSum not found

Solution

1. Step 1: Understand the shared library usage

   The library 'utils' is loaded, so its functions like calculateSum are available.

2. Step 2: Evaluate the function call and output

   calculateSum(2, 3) returns 5, so echo prints "Sum is 5".

3. Final Answer:

   Sum is 5 -> Option A

4. Quick Check:

   Function call returns 5, echoed output matches [OK]

Hint: Function returns sum, echo prints it directly [OK]

Common Mistakes:

• Concatenating numbers as strings (23)
• Printing function call text instead of result
• Forgetting to load the shared library

4. You wrote this Jenkins pipeline snippet:

@Library('common-lib') _
pipeline {
  agent any
  stages {
    stage('Build') {
      steps {
        script {
          commonLib.buildApp()
        }
      }
    }
  }
}

But Jenkins reports: groovy.lang.MissingPropertyException: No such property: commonLib. What is the likely cause?

medium

A. The library name 'common-lib' is incorrect or not configured.

B. You must assign the library to a variable to use it like commonLib.

C. You forgot to add the underscore after @Library annotation.

D. Shared libraries cannot be used inside script blocks.

Solution

1. Step 1: Understand @Library usage with variable assignment

   When using @Library('name') without assignment, library classes are imported globally, but to use a variable like commonLib, you must assign it.

2. Step 2: Identify the error cause

   The error says commonLib is missing, meaning the library was not assigned to that variable.

3. Final Answer:

   You must assign the library to a variable to use it like commonLib. -> Option B

4. Quick Check:

   Assign library to variable to call methods [OK]

Hint: Assign library to variable to call methods [OK]

Common Mistakes:

• Assuming library auto-creates variables
• Thinking underscore fixes variable issues
• Believing shared libraries can't be used in script blocks

5. You have multiple Jenkins pipelines that all use the same code to send notifications and run tests. How does using a shared library improve your setup?

medium

A. It duplicates the code in each pipeline for faster execution.

B. It lets each pipeline run notifications and tests in parallel automatically.

C. It removes the need to write any pipeline scripts at all.

D. It centralizes notification and test code, so updates apply everywhere automatically.

Solution

1. Step 1: Identify the problem with duplicated code

   Having the same notification and test code copied in many pipelines causes maintenance issues.

2. Step 2: Explain how shared libraries solve this

   Shared libraries keep this code in one place, so changing it once updates all pipelines using it.

3. Final Answer:

   It centralizes notification and test code, so updates apply everywhere automatically. -> Option D

4. Quick Check:

   Central code means easier updates and less duplication [OK]

Hint: Centralize common code to update once for all pipelines [OK]

Common Mistakes:

• Thinking shared libraries run steps in parallel
• Believing shared libraries remove all scripting
• Assuming shared libraries duplicate code instead of reusing