Documentation for Bamboo 4.0.x. Documentation for earlier versions of Bamboo is available too.

There may be times when you want to prevent a failing test from causing the whole build to fail.

Possible scenarios where this may be useful include:

  • You want to build an artifact despite there being a failing test, but can't do this while the plan build is failing.
  • In test-driven development (TDD), a test will fail until the functionality is implemented - you want to quarantine all but the relevant tests.
  • A test may give unpredictable results, perhaps because of infrastructure issues or dependencies.
  • You want to remove a test from a build, but don't want to alter or delete the test source code because doing so could affect another Bamboo plan.

In Bamboo, you can temporarily disconnect any test's results from the plan build results by quarantining the test. The test is still run whenever the plan is built, but the test's results do not affect the plan's build results.

You can always restore a test's results to the build results when required, for example if the test is now passing.

All the quarantined tests for a plan are displayed on the Quarantined Tests tab of the plan summary. The status bar for each test shows the recent build history of the test.

On this page:

Related pages:

To quarantine a failing test

You need plan administrator permission to quarantine a test.

  1. Choose Dashboard > All Plans > #buildresult to go to the build result where the test is failing.
  2. Click Quarantine for the failing test (in the 'Build Result Summary' screen).

To restore a quarantined test to a build

You need plan administrator permission to restore a test.

  1. Choose Dashboard and click on a plan to go to the plan's summary.
  2. Click the Quarantined Tests tab.
  3. Click Unleash for the test to be restored.

Screenshot: The quarantined tests for a plan, showing the Status bar.

  • No labels

1 Comment

  1. Quinton McCombs

    Jun 26, 2012

    If you have one or more quarantined tests, the outcome of the task will be changed to success if there are no unquarantined tests failing. This can be a problem because if there is a compilation failure, the task will still be reported as a success! This is currently a bug in Bamboo.

    Fortunately, there is a work around to this issue. Instead of using a single task to perform your build and parse the test results, use the JUnit parser task to parse the test results. This will ensure that compilation failures will still fail your build.

     



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.