Boilerplate project for development of Jenkins shared library and pipelines.

JenkinsLibrary aims to help developers to easily start new project with Jenkins Shared library and pipelines. It addresses poorly documented nuances of setting up Gradle project and build environment required for running Unit and Integration tests, adding correct versions of Jenkins plugins to dependencies etc.

Important feature of JenkinsLibrary is that it keeps both Shared library and pipelines which use it inside the same project which makes development and testing significantly simpler comparing with the setup where library and pipelines are kept in separate projects. Still, if you prefer to use JenkinsLibrary as a separate project for library classes only and reuse it in multiple projects with pipeline-only code, it allows you to do so without any modifications.

JenkinsLibrary uses JenkinsPipelineUnit library for mocking pipeline steps and variables, but on top of it adds Spock v2 framework which allows to use more precise and self-explanatory syntax of describing test cases.

1. Usage
2. Setting up in JetBrains IDEA
3. Development environment
4. Directory structure
5. Contributing

• ./dev test: build project and execute tests.
  If you provide arguments after ./dev test command, they are appended to gradle clean test command-line and resulting command is executed
• ./dev test --tests "pipelines.admin.**": build project and execute all tests in pipelines.admin package
• ./dev test --tests "pipelines.admin.**" --tests org.example.FooSpec: build project and execute all tests in pipelines.admin package and tests for class org.example.FooSpec
• ./dev test -Dpipeline.stack.write=true: build project, execute tests and update call stack files

• ./dev docker [--push]: only build Docker image. If --push switch is provided, Docker image is pushed to Docker Hub
• ./dev help: display this help about commands
• ./dev lint: lint project with MegaLinter
• ./dev sh: create development environment and enter shell session inside it. Inside development environment you can use Gradle to execute any advanced commands

Execute ./gradlew openIdea in the project. When IDEA opens the project click Skip if it proposes to import Gradle project

The development environment invoked by ./dev sh command is very compact so in most situation you are fine to use your native environment for building and executing tests. All you need is to have Java 11 and Gradle 8 available in the PATH.

Recommended way of usage is the ./dev wrapper (see Usage) but if you would like to use native environment you can use SDKMan for installing and switching versions of tools from JVM stack.

Project follows the directory structure of Jenkins Shared Library project. On top of that, test and other directories have been added for keeping files related to additional features. Most directories have detailed Readme files with the description and other important information about their contents and naming conventions:

• pipelines: Jenkins pipelines
• resources: Production resources directory
• test/pipelines: Tests for jenkins pipelines. Structure of this directory follows the structure of pipelines directory
• test/resources: Test resources directory
• test/resources/callStacks: Call stack dumps directory. This directory contains expected call stack dumps for the pipeline tests

See How to contribute document