Xray supports integration with some well known Continuous Integration tools but it can be used with other ones thanks to Xray's REST API.
Popular CI tools
Xray provides an add-on for Bamboo which makes it easy to use Xray in Continuos Integration scenarios where Bamboo it the CI tool of choice. Please see the add-on page for usage instructions.
Legacy instructions
Please read the blog posts bellow for detailed procedures on how to setup your CI tool.
Other tools
Case you need to integrate with another CI tool, normally you will have to follow these steps.
Export tests from JIRA
- Run the tests
- Import the results back to JIRA
Note that you might have your tests specification in your Version Control System (e.g. GIT, SVN) and prefer to implement CI from there onwards. In that case, in step 1, you would obtain the tests from your VCS.
Learn more
Please take a look at the general guidelines for Working with automated Tests and also the specifics for Testing with Cucumber.
CI in a project using Cucumber tests
Export Cucumber tests
curl -u admin:admin http://xrayserver/rest/raven/1.0/export/test?keys=CALC-173 -o features/features.zip
Unzip the tests (Cucumber .feature files)
unzip -o features/features.zip -d features/
Run the tests and save the report
cucumber -x -f json -o report.json
Import the test results to JIRA
curl -H “Content-Type: application/json” -X POST -u admin:admin –data @report.json http://xrayserver/rest/raven/1.0/import/execution/cucumber