This is the documentation for Bamboo 5.5. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

This page describes how to configure a Bamboo task to use Ant.

See  Configuring a builder task for an overview of Bamboo builder tasks.

To configure an Ant task:

  1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
  2. Click the name of an existing Ant task, or click Add Task and then Ant to create a new task.
  3. Complete the following settings:
     

    Task DescriptionA description of the task, which is displayed in Bamboo.
    Disable this taskCheck, or clear, to selectively run this task.
    Executable

    The Ant executable that is available to perform the task. The executable that you select will become one of the task's (and so, the job's) requirements.

    You can add other executables, if required.

    Build FileThe name of your existing build file (e.g. build.xml).
    You can include variables (see Using Global or Build-specific Variables).
    TargetThe Ant target that you want this Bamboo task to execute (e.g. test).
    You can use '-D' to define one or more JVM parameters (e.g.: -Djava.awt.headless="true"). You must use double quotes around the parameter value; single quotes are considered as part of the actual value.
    Multiple Ant targets can be specified with a space-delimited list.
    You can also include variables (see Using Global or Build-specific Variables).
    Build JDK

    The JDKs that are available to perform the task. The JDK that you select will become one of the task's (and so, the job's) requirements.
    You can add other JDKs, if required.

    Environment Variables(Optional)  Additional system environment variables that you want to pass to your build. Note that existing environment variables are automatically available to the executable. You can also include Bamboo global or build-specific variables (see Using global, plan or build-specific variables).
    Multiple variables should be separated with spaces. Parameters with spaces must be quoted (e.g ANT_OPTS="-Xms200m -Xmx700m").
    Working Sub Directory (Optional)  An alternative subdirectory, relative to the job's root directory, where Bamboo will run the executable. The root directory contains everything checked out from the job's configured source repository. If you leave this field blank, Bamboo will look for build files in the root directory. This option is useful if your task has a build script in a subdirectory and the executable needs to be run from within that subdirectory.
    The build will produce test resultsSelect to specify the directory, relative to the root directory, where test results will be created. You can use Ant-style patterns such as **/test-reports/*.xml. Bamboo requires test results to be in JUnit XML format.
    (warning) For jobs that use CVS, the root directory is <bamboo-home>/xml-data/build-dir/JOB_KEY/<cvs-module>.
  4. Click Save.