开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Jenkins Pipeline Library

Since Jenkins Pipeline has reached a certain state of production scripted pipelines are the way to go.

But: Not everything known from the UI is available in Pipeline and configuring and writing scripts is not so easy for the normal developer.

The target of this library is to take out some complexity (and yes adding some too) of the pipeline creation and to bring back some known functionality (for example GIT_BRANCH and SCM_URL environment variables, mail notification on still unstable etc.)

Want to see an example? Have look at Usage examples

Table of contents

• Key concepts
• Requirements
• Steps
• Utilities
• Credential and managed file auto lookup
• Support for command line execution
• Setup your environment to use the pipeline library
• Building/Testing
  • Building with maven
• Changes / Version History

Key concepts

The pipeline library was developed with a focus to ease Java and Maven build processes within companies which have a more or less similiar project structure e.g.

• Maven/Java
• local Artifact Server (like Sonatype Nexus or Artifactory)
• GIT

The assumption is that in these environments

• Jenkins has a dedicated user account to checkout code (or one per project)
• the artifact server caches public artifacts and acts as a internal artifact server

❓ So why configure maven repositories and scm credentials in every pipeline?

So the key concepts of the pipeline enable you to

• Auto provide credentials (no worries, only Jenkins credential ids, not the credential itself) (see Credentials)
• Auto provide maven settings (see ManagedFiles)
• configure each job the same way (see ConfigStructure)
• log and see the things you are interested in (see Logging)

to builds.

Running this pipeline library will result in more structured and easier to maintain pipeline scripts.

Configured properly this library enables you to checkout scm with these lines of code:

import static io.wcm.devops.jenkins.pipeline.utils.ConfigConstants.*
checkoutScm( (SCM) : [
        (SCM_URL) : "[email protected]/group/project.git",
    ]
)

Or running maven with local and global maven settings with these lines of code:

import static io.wcm.devops.jenkins.pipeline.utils.ConfigConstants.*
execMaven( 
    (SCM) : [
        (SCM_URL) : "[email protected]/group/project.git",
    ],
    (MAVEN): [
        (MAVEN_GOALS) : [ "clean", "install" ]
    ]
)

❓ Looking for an example on how a pipeline script looks like when using Pipeline? Have a look at Usage examples