Flexible Publish

• Use a publisher more than once within a build
• Select the execution order of the publishers
• Use Run Conditions to decide whether to publish
• Use Builders as actions by installing the Any Build Step Plugin (which will also install the Conditional BuildStep Plugin)

Always use Always

If you always add your Post-build Actions to Flexible publish, then not only will you be able to change the execution order afterwards, but you will have the ability to temporarily disable a publisher without losing the publishers' configuration.
You can just switch between the Always and the Never run conditions.

This plugin can be installed from the Update Center (Manage Jenkins > Manage Plugins)

In Manage Jenkins/ Script console, copy the following to see which publishers can be moved (for a job named 'My Job')

import static org.jenkins_ci.plugins.flexible_publish.JobUpdater.*

def job = Jenkins.instance.getItem('My Job')
list job

Or, if you like doing it the hard way ...

org.jenkins_ci.plugins.flexible_publish.JobUpdater.list(hudson.model.Hudson.instance.getItem('My Job'))

You should see a list something like this

Result: Enabled publishers that can be moved:
    [Publish Checkstyle analysis results]
    [Publish FindBugs analysis results]
    [Publish PMD analysis results]
    [Publish duplicate code analysis results]
    [Scan for compiler warnings]
    [Scan workspace for open tasks]
    [Publish combined analysis results]
    [Archive the artifacts]
    [Publish JUnit test result report]
    [Publish Javadoc]
    [Record fingerprints of files to track usage]
    [Git Publisher]
    [Send build artifacts over FTP]
    [Send build artifacts over SSH]
    [Send build artifacts to a windows share]

Enabled publishers that cannot be moved:
    [Aggregate downstream test results]
    [Build other projects]
    [Record Emma coverage report]
    [Report Violations]
    [E-mail Notification]

You can move a publisher into Flexible publish

import static org.jenkins_ci.plugins.flexible_publish.JobUpdater.*

def job = hudson.model.Hudson.instance.getItem('My Job')
movePublisher job, 'Publish JUnit test result report'

After moving one or more publishers, go to the configure page, check everything looks ok, then save the configuration.

If you like to live on the edge, and would like to move all of the publishers in one go, then ...

import static org.jenkins_ci.plugins.flexible_publish.JobUpdater.*

def job = hudson.model.Hudson.instance.getItem('My Job')
moveAllPublishers job

When you use Flexible Publish Plugin with multi-configuration projects (aka. matrix projects), you should know followings:

Generally, publishers run in two phase for multi-configuration projects.

1. Run for each combination of axes. It works just like in Free Style Projects.
2. Run for whole the multi-configuration project. This is what is called aggregation.

For example, "Publish JUnit test result report" works:

1. see test results in each combination of axes
2. sum up the results of all of the combinations.

You can specify conditions both for each combination and the aggregation.
If you want to separate condition for them, check "Condition for Matrix Aggregation" (This appears only in multi-configuration projects).

This is especially useful for the case you want control the execution of the publisher depends on combination of axes.
Be careful to specify the condition, for inconsistent execution causes the build fails.

• Available since flexible-publish-0.15.

• You can specify "Execution Strategy" with which flexible publish decides how to work when a publisher fails.

  Execution Strategy	Behavior on a failure of a publisher
  Fail at end	Continues to run following publishers. The default behavior in flexible-publish 0.15 and later.
  Fail fast	Doesn't run following publishers. The default behavior for flexible-publish configured in 0.13 and 0.14.1.

• This works as followings:

  • Example configuration

    Flexible Publish
        Condition 1
            Publisher 1
            Publisher 2
        Condition 2
            Publisher 3
    

  • When Publisher 1 fails, following publishers are handled as:

    Execution Strategy for Condition 1	Publisher 2	Publisher 3
    Fail at end	Performed	Performed
    Fail fast	Not performed	Performed

    • Following conditions are always performed even prior publishers failed.
    • Following publishers in a same condition is performed when the execution strategy is "Fail at end".

• Some publishers may not be prepared to run more than once during a build
• Some publishers need to find themselves configured in the projects, but fail to do that when included in Flexible Publish.

• Some publishers display side links in project status pages and build status pages.
• Configuring multiple publishers of a same kind results duplicated side links like this (this is a case with Email-ext plugin):
  
• There's no proper and general way to fix this, and this isn't planned to be fixed as it's harmless.

• Email-ext plugin
• DocLinks Plugin
• testng-plugin

• Warnings Plugin
• Static Code Analysis Plug-ins
• testng-plugin

• It's often accused that "Flexible Publish plugin should have been named Conditional Publisher plugin"
• You couldn't reorder publishers with old Jenkins (Jenkins < 1.463). Also see https://groups.google.com/forum/?fromgroups\#\\!topic/jenkinsci-dev/UQLvxQclyb4
• A feature to reorder publishers was as important as a feature to launch publishers conditionally. So named "Flexible Publish".

To report a bug or request an enhancement to this plugin please create a ticket in JIRA (you need to login or to sign up for an account). Also have a look on How to report an issue

• Bug report
• Request or propose an improvement of existing feature
• Request or propose a new feature