Skip to content

Testing

JTE tests are written using Spock and make heavy use of the Jenkins Test Harness.

Mocking

In general, mocking is discouraged. It is preferred that instead, the Jenkins Test Harness is used to create actual JTE Pipeline Runs that exercise the functionality to be tested.

This approach results in tests that are easier to write, decoupled from the technical implementation of the feature, and produce higher confidence that the functionality will work in a Jenkins pipeline.

Given the nuances of CPS - nothing beats the real thing when validating JTE is working as expected.

Work in Progress

You'll find examples of unit tests using Spock's mocking functionality. These tests should be refactored to use the Jenkins Test Harness as time allows.

Test Utilities

There are several utility test classes that help perform common setup operations for tests.

Test Class Description
TestFlowExecutionOwner simplifies mocking FlowExecutionOwner
TestLibraryProvider a utility for creating libraries to test
TestUtil a helper for creating JTE pipeline jobs to test

Testing Git Repositories

The GitSampleRepoRule from the git plugin is used to create local git repositories.

See AdHocTemplateFlowDefinitionSpec for examples of usage.

Testing Pipeline Resumability

The RestartableJenkinsRule is used for testing that JTE pipelines can be successfully resumed after being paused or after a Jenkins graceful restart.

See ResumabilitySpec for examples of usage.

Back to top