Bamboo 3.1 and later
On this page:
Purpose of this Module TypeA task plugin represents a unit of work during a Build. Each Job can now have multiple Tasks which run in order on a single Agent. If a Task fails the following tasks will not execute, with the exception of Final Tasks which will always execute.
Tasks are designed to be easily extensible. To get a basic Task up and running, you simply need to implement a single Java interface. However, there are optional extension points that allow you to add a configuration screen and other powerful features to your Task.
You can find in-depth details on creating a Task on the Tasks Overview page.
If you are looking to upgrade a Builder to a Task please see the LegacyBuilderToTaskConverter Plugin Module
Minimal TaskType plugin
Advanced TaskType plugin
All TaskType modules must implement the TaskType interface.
In the example,
The human-readable name of the plugin module. This name will be displayed when configuring Tasks
Your TaskType class. It must implement TaskType and provide the logic for executing a Task
The description will be displayed to the user when selecting the TaskType to add to their Job.
Determines which categories the TaskType will be displayed in, in the TaskType picker. You can have multiple category definitions. Available categories are "builder", "test", "deployment"
Allows you to define an Executable Type that users can add as Capabilities on their Agents. You can then add Requirements on these Capabilities
Allows you to automatically detect Executables that the agent/server may have and add them as Capabilities
Provide a way for users to configure your Task.
view freemarker resource
The Freemarker template to be displayed when editing your task configuration (required if configuration element supplied)
edit freemarker resource
The Freemarker template be displayed when viewing your task configuration (required if configuration element supplied)
Get started writing your own Tasks with the following Tutorials: