Matrix Reloaded Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID matrix-reloaded Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
1.1.1
Jun 05, 2013
1.420
downstream-ext (version:1.7, optional)
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
Christian Wolfgang (id: wolfgarnet)
Usage Installations 2013-Apr 447
2013-May 480
2013-Jun 487
2013-Jul 522
2013-Aug 539
2013-Sep 564
2013-Oct 612
2013-Nov 599
2013-Dec 603
2014-Jan 626
2014-Feb 643
2014-Mar 667

Developed by

Sponsored by

The Matrix Reloaded Plugin allows rebuilding parts of an already built Matrix build.

Rebuilding a Matrix build

On all Matrix builds that has run while the plugin was installed there will be a Matrix reloaded link. Click this, and it will take you to a dialog, where you can check-mark the configurations that should be build again. Nothing is checked by default, but the check-marks you set will be cascaded as default settings, if applicable, to any down-stream jobs triggered by the re-run.

Typical Use Case

Occasionally when using matrix builds some of the configurations may fails due to reasons, that are not necessarily related to the quality of your code. We refere to tem as false negatives, typical examples could be that a slave didn't manage to obtain a license for some product you are dependent on, a glitch in the network communication or a wrong hard-ware configuration for the particular slave that ran it.

When that happens, you would probably want to rebuild those false negatives simply by rerunning them and then paint over the original result in the matrix with the new one.

With the Matrix Reloaded Plugin installed, all matrix builds will hereafter offer a link named "Matrix reloaded" which takes you to a dialog where you are presented to the original results of the matrix run and offered an option to mark to ones you want to rebuild.

When you hit the "Rebuild Matrix" button a new Matrix build is scheduled for execution. In the result all the configurations that were not selected for rebuilding will continue to point to the original build results, while the configurations that you did select are being rebuild and replaced in the new resulting matrix.

Reload option sometimes not available
The Matrix Reloaded link is only available on the builds that were executed while the Matrix Reloaded Plugin was actually installed. Sometimes you may see a Matrix Build, that doesn't offer the Reload option, even though you did install the plugin. When that happens you can simply do a regular re-run (of the entire matrix) and the Matrix Reloaded option will be available on the new result.

Using Matrix Reloaded

Once a build has been run, a link in the side panel of the Matrix build and each of the sub runs have been added. This can be seen in the following image:

When the "Matrix Reloaded" link is clicked, the user can select which runs to rebuild. See the following image:

By default the failed and unstable runs are checked.

When the "Rebuild Matrix" button is clicked, the resulting build should, hopefully, look like:

Matrix Runs

Selecting a specific Matrix run from a Matrix build, the "Matrix Reloaded" link checks that specific run by default and no other run.

Downstream building

It is possible to let downstream builds inherit the Matrix Loaded configuration. This will rebuild the same combinations in any downstream project.
If the downstream project does not have any of the combinations, none will be build. If the downstream project have some of the combinations, those will be build. Just check Matrix Reload downstream builds.

Considerations

We do not plan that the Matrix Reloaded plugin should have any influence on jobs actually being rebuild. This could potentially create a a bit of a paradox: If a build is rebuilding only some configurations and the job is configured to get the latest commit from a SCM, and a new commit actually exists, then some of the configurations are based on one commit, while others are actually based on the newer commit.

Potentially a mess!

Issues

Changelog

Version 1.1.1(2013-6-5) Thanks to lvotypko for the contributions.
  • Bubble links on matrix reloaded action have incorect url (issue #17748)
  • matrix rebuild allows all users to issue builds (issue #16628)
  • Fix bad url for configurations.
Version 1.1.0(2012-6-5)
  • Use Action instead of state object (issue #13670)
  • Matrix Reloaded should trigger the same combination in downstream matrix job (issue #13514)
  • Link to plugin from plugin configuration page is wrong (issue #12227)
Version 1.0.2(2012-1-27)
  • Matrix Reloaded rebuilds entire matrix instead of just selected ones (issue #11647)
Version 1.0.1(2011-6-21)
  • Updated design to comply with baseBuild
Version 1.0.0(2011-5-23) Initial release

Design wiki: Matrix Reloaded Plugin Design

Labels

Edit
matrix matrix Delete
redo redo Delete
rebuild rebuild Delete
reuse reuse Delete
reload reload Delete
plugin-misc plugin-misc Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.