Introduction to the Contra HDSL¶
Welcome to the Contra HDSL documentation!
The Contra HDSL is a high level DSL shared library for Jenkins. The library is built on Groovy and the core Jenkins pipeline steps. The Contra HDSL seeks to simplify the creation of Jenkins pipeline files by presenting building blocks, or primitives, which can be called from scripted or declarative pipelines.
Why use the Contra HDSL?¶
Writing and maintaining non-trivial Jenkinsfiles can be an overwhelming task. The Contra HDSL seeks to provide a set of primitives which match to frequently used aspects of creating CI/CD Jenkinsfiles. These include:
- Deploying infrastructure
- Configuring infrastructure
- Executing tests
- Reporting results
- Saving artifacts
- Tearing down infrastructure
The Contra HDSL attempts to be a flexible set of primitives that don’t preclude using any additional Jenkins plugins, etc.
Note
Releases are formatted using semantic versioning. If the release shown above is a pre-release version, the content listed may not be supported. Use latest for the most up-to-date documentation.