https://github.com/jenkinsci/matrix-combinations-plugin

Jenkins Plugin which enable choosing which combinations of matrix build the user want to run
https://github.com/jenkinsci/matrix-combinations-plugin

adopt-this-plugin

Last synced: 8 months ago
JSON representation

Jenkins Plugin which enable choosing which combinations of matrix build the user want to run

• Host: GitHub
• URL: https://github.com/jenkinsci/matrix-combinations-plugin
• Owner: jenkinsci
• License: mit
• Created: 2013-10-07T10:53:42.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-08-08T14:42:46.000Z (almost 2 years ago)
• Last Synced: 2025-01-30T04:41:29.339Z (over 1 year ago)
• Topics: adopt-this-plugin
• Language: Java
• Homepage: https://plugins.jenkins.io/matrix-combinations-parameter/
• Size: 209 KB
• Stars: 1
• Watchers: 99
• Forks: 19
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Matrix combinations parameter plugin for Jenkins

This plugin allows a user to choose which matrix combinations he wants to run, as opposed to the default behaviour where jenkins runs all combinations and translate it into a groovy condition such as:

```groovy

axis1=="axis1value1" && axis2=="axis2value1" || axis1=="axis1value2" && axis2=="axis2value2" || ...

```

## Configuration

After installation a new type of parameter was added (Matrix Combinations Parameter).

 

![Matrix combinations parameter definition example](docs/images/MatrixCombinationsParameterDefinitionExample.png)

-   Configure your matrix job and add exactly one parameter with this type

-   Fill the name of the parameter

-   Define the Axes as usual

  

## Usage

After clicking the build, the user gets a html table with a checkbox for each matrix combination.

After clicking the submit button, only checked combinations will run.

![Matrix combinations parameter value example](docs/images/MatrixCombinationsParameterValueExample.png)

## Acknowledgements

Many thanks to Nathan Grunzweig for giving me the idea and help with the implementation of this plugin.  

I would also like to thank Christian Wolfgang, who developed the Matrix Reloaded Plugin which gave me the inspiration to implement it.