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.
To quarantine a failing test
You need plan administrator permission to quarantine a test.
- Choose Dashboard > All Plans > #buildresult to go to the build result where the test is failing.
- 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.
- Choose Dashboard and click on a plan to go to the plan's summary.
- Click the Quarantined Tests tab.
- Click Unleash for the test to be restored.
Screenshot: The quarantined tests for a plan, showing the Status bar.