This plugin adds batch tasks that are not regularly executed to
projects, such as releases, integration, archiving, etc. In this way,
anyone in the project team can execute them in a way that leaves a
record.

# Usage

When you install this plugin, your project configuration page gets
additional "batch tasks" option as illustrated below:

![](docs/images/task-config.png)

A batch task consists of a shell script and a name. When you execute a
build, the shell script gets run on the workspace, just like a build.
Batch tasks and builds "lock" the workspace, so when one of those
activities is in progress, all the others will block in the queue.

Once a task is configured, the project top page gets "task(s)" link, as
illustrated below:

![](docs/images/task-project-top.png)

If you click that, you can see the status of all the tasks. You can
schedule the execution of a task from here, too. Task executions are
numbered like "123-456" where 123 portion refers to the latest build and
456 portion refers to the sequential number (so that you can execute a
task multiple times with the same build.) The build number portion is
significant because when a batch task runs, it sees the workspace as of
the result of this build.

![](docs/images/task-top.png)

The details of the task execution and its console output are available
by further clicking a task of the interest, as below:

![](docs/images/task-builds.png)

# Change Log

#### Version 1.19 (Jul. 1, 2016)

-   Fix
    [JENKINS-36184](https://issues.jenkins-ci.org/browse/JENKINS-36184) -
    Batch task console is empty

#### Version 1.18 (Jun. 7, 2016)

-   Fix
    [JENKINS-35411](https://issues.jenkins-ci.org/browse/JENKINS-35411) -
    Migrate to pom-plugin
-   Fix
    [JENKINS-35188](https://issues.jenkins-ci.org/browse/JENKINS-35188) -
    Improve User Experience

#### Version 1.17 (Fev. 24, 2013)

-   Fix reopened
    [JENKINS-13647](https://issues.jenkins-ci.org/browse/JENKINS-13647) -
    Environment variables from EnvInject plugin are not inherited/parsed
    by batch tasks

#### Version 1.16 (May 1, 2012)

-   Fix
    [JENKINS-13647](https://issues.jenkins-ci.org/browse/JENKINS-13647) -
    Environment variables from EnvInject plugin are not inherited/parsed
    by batch tasks

#### Version 1.15 (Apr 5, 2012)

-   Refactored internally to [support hierarchical
    project](https://wiki.jenkins.io/display/JENKINS/Hierarchical+projects+support)

#### Version 1.14 (Nov 11, 2010) - *requires Hudson 1.383+*

-   Fixed an AbstractMethodError when running with Hudson 1.383+ ([issue
    \#8033](http://issues.jenkins-ci.org/browse/JENKINS-8033))

#### Version 1.13 (Feb 10, 2010)

-   Use resizable text area for task script.
    ([JENKINS-5578](https://issues.jenkins-ci.org/browse/JENKINS-5578))
-   Apply environment settings from
    [setenv](https://wiki.jenkins.io/display/JENKINS/Setenv+Plugin) plugin
    when running tasks.
    ([JENKINS-5580](https://issues.jenkins-ci.org/browse/JENKINS-5580))
-   Show links to downstream tasks on project page.
    ([JENKINS-5582](https://issues.jenkins-ci.org/browse/JENKINS-5582))

#### Version 1.12 (Feb 5, 2010)

-   Lock workspace during task run to prevent owner project or other
    tasks from using the same workspace.
    ([JENKINS-5285](https://issues.jenkins-ci.org/browse/JENKINS-5285))
-   Show animated ball icon for Tasks link in sidepanel when a task is
    running.
    ([JENKINS-3372](https://issues.jenkins-ci.org/browse/JENKINS-3372))

#### Version 1.11 (Jan 3, 2010)

-   Environment variable bug fix and enhancements
    ([JENKINS-5039](https://issues.jenkins-ci.org/browse/JENKINS-5039),
    [JENKINS-1628](https://issues.jenkins-ci.org/browse/JENKINS-1628),
    [JENKINS-1316](https://issues.jenkins-ci.org/browse/JENKINS-1316))

#### Version 1.10 (Dec 7, 2009)

-   A few minor bug fixes.

#### Version 1.9 (Nov 5, 2009)

-   Add "trigger even if build is unstable" selector for invoking tasks
    as a post-build action. Previously the tasks were always invoked
    (even for failed builds); now they will only run if the build result
    meets the required threshold (and never for failed builds).
-   Fix build number written to job log when task is invoked as a
    post-build action (was off by one)
-   Fix broken image for aborted task (grey ball)
-   On task page, show only builds for this task in Build History
    (instead of all tasks)
-   Avoid error if try to run a task when there are no builds for the
    project

#### Version 1.8 (Aug 28, 2009)

-   Improved the error diagnosis and recovery when a build no longer has
    a workspace
    ([report](http://www.nabble.com/NPE-with-batch-task-plugin-and-1.321-td25194567.html))
    – requires Hudson 1.319 or higher.

#### Version 1.7 (Mar 31, 2009)

-   Allow non-admin users ability to manage and execute tasks
    ([JENKINS-1198](https://issues.jenkins-ci.org/browse/JENKINS-1198))

#### Version 1.6 (Feb 27, 2009)

-   Updated to work with recent versions of Hudson
    ([JENKINS-3173](https://issues.jenkins-ci.org/browse/JENKINS-3173))

#### Version 1.5 (Jan 27, 2009)

-   Fixed a bug "batchtask in queue causes NPE at startup"
    ([JENKINS-2925](https://issues.jenkins-ci.org/browse/JENKINS-2925))

#### Version 1.3 (Jan 29, 2008)

-   Updated to work with the latest version of Hudson, so that it won't
    cause `AbstractMethodError`
    ([report](http://www.nabble.com/Hudson---Problems-with-white-spaces-in-URLs-pointing-to-build-artifacts--td15088015.html#a15088729))
-   Last successful/failed builds were computed incorrectly
    ([JENKINS-1012](https://issues.jenkins-ci.org/browse/JENKINS-1012))
-   Icon size in task list is now configurable
    ([JENKINS-1010](https://issues.jenkins-ci.org/browse/JENKINS-1010))

#### Version 1.2 (Nov 16, 2007)

-   Task can be now individually deleted from the left menu
-   Build number should start from 1
    ([JENKINS-991](https://issues.jenkins-ci.org/browse/JENKINS-991))
-   Tasks now work on Windows
    ([JENKINS-985](https://issues.jenkins-ci.org/browse/JENKINS-985))
-   Build icon in task list is not larger than the other icons
    ([JENKINS-1010](https://issues.jenkins-ci.org/browse/JENKINS-1010))

#### Version 1.0 (Oct 18, 2007)

-   initial version