---
title: "Trigger a BitBucket pipeline"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44565651/Trigger%20a%20BitBucket%20pipeline"
format: markdown
---
> Macro (toc)
# Bitbucket Cloud/Pipelines
## Trigger a Bitbucket pipeline build from an issue
In this very simple scenario, we'll implement a rule, triggered manually, that will trigger a Bitbucket pipeline build. The action will be available from the "Automation" panel, in all issues of the selected project.
We're assuming that:
- you just want to trigger a CI job, period; this job may be totally unrelated to the issue from where you triggered it
- what the CI job will do, including if it will report the results back to Xray or not, is not relevant
### Bitbucket configuration
In Bitbucket we need to configure the pipeline as usual; no special configuration is needed. Some [variables can be used and defined at multiple layers](https://support.atlassian.com/bitbucket-cloud/docs/variables-in-pipelines/).
bitbucket-pipelines.yml
```yml
# Use Maven 3.5 and JDK8
image: maven:3.5-jdk-8
pipelines:
default:
- step:
caches:
- maven
script:
- |
echo "building my amazing repo..."
mvn test
export token=$(curl -H "Content-Type: application/json" -X POST --data "{ \"client_id\": \"$client_id\",\"client_secret\": \"$client_secret\" }" https://xray.cloud.xpand-it.com/api/v1/authenticate| tr -d '"')
echo $token
curl -H "Content-Type: text/xml" -H "Authorization: Bearer $token" --data @target/surefire-reports/TEST-com.xpand.java.CalcTest.xml "https://xray.cloud.xpand-it.com/api/v1/import/execution/junit?projectKey=CALC&testPlanKey=$testplan"
echo "done
```
### Automation configuration
1. create a new rule and define the "When" (i.e. when it to should be triggered), to be "Manually triggered"
2. define an action (i.e. the "Then") as "Send web request" and configure it as follows
custom data (i.e. HTTP body content)
```javascript
{
"target": {
"ref_type": "branch",
"type": "pipeline_ref_target",
"ref_name": "master"
}
}
```
- the Webhook URL provided above follows the [Bitbucket pipelines REST API syntax ](https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/pipelines/)
- https://api.bitbucket.org/2.0/repositories///pipelines/
- the Webhook HTTP POST body content, defined in the "Custom data" field, will be used to identify the target branch and also a variable containing the Test Plan issue key that will be accessible to the pipeline build
**custom data (i.e. HTTP body content)**
- besides the "Content-Type" header that should be "application/json", define also an "Authorization" header having the value "Basic ", where the base64 encoded can be [generated](https://www.blitter.se/utils/basic-authentication-header-generator/) using your Bitbucket credentials
After publishing the rule, you can go to the screen of an issue and trigger the Bitbucket pipeline build.
In this case, a new Test Execution would be created in Jira/Xray.
## Trigger a Bitbucket pipeline build from a Test Plan and report the results back to it
In this simple scenario, we'll implement a rule, triggered manually, that will trigger a Bitbucket pipeline build. The action will be available from the "Automation" panel, for all Test Plan issues of the selected project.
We're assuming that:
- you just want to trigger a CI job, period; this job may be totally unrelated to the issue from where you triggered it
- the results will be submitted back to Xray, if the pipeline is configured to do so
### Bitbucket configuration
In Bitbucket pipeline definition we will make use of a variable named "testplan" (referenced by $testplan). This variable does not need to be defined explicitly as such in Bitbucket; Bitbucket will pass to the pipeline all "variables" identified in the REST API request, if so, whenever triggering the pipeline.
bitbucket-pipelines.yml
```yml
# Use Maven 3.5 and JDK8
image: maven:3.5-jdk-8
pipelines:
default:
- step:
caches:
- maven
script:
- |
echo "building my amazing repo..."
mvn test
export token=$(curl -H "Content-Type: application/json" -X POST --data "{ \"client_id\": \"$client_id\",\"client_secret\": \"$client_secret\" }" https://xray.cloud.xpand-it.com/api/v1/authenticate| tr -d '"')
echo $token
curl -H "Content-Type: text/xml" -H "Authorization: Bearer $token" --data @target/surefire-reports/TEST-com.xpand.java.CalcTest.xml "https://xray.cloud.xpand-it.com/api/v1/import/execution/junit?projectKey=CALC&testPlanKey=$testplan"
echo "done
```
### Automation configuration
1. create a new rule and define the "When" (i.e. when it to should be triggered ), to be "Manually triggered"
2. define the condition so that this rule can only be executed from Test Plan issue; we could also define this on the previous step
3. define an action (i.e. the "Then") as "Send web request" and configure it as follows
- the Webhook URL provided above follows the [Bitbucket pipelines REST API syntax](https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/pipelines/)
- https://api.bitbucket.org/2.0/repositories///pipelines/
- the Webhook HTTP POST body content, defined in the "Custom data" field, will be used to identify the target branch and also a variable containing the Test Plan issue key that will be accessible to the pipeline build
**custom data (i.e. HTTP body content)**
- besides the "Content-Type" header that should be "application/json", define also an "Authorization" header having the value "Basic ", where the base64 encoded can be [generated](https://www.blitter.se/utils/basic-authentication-header-generator/) using your Bitbucket credentials
After publishing the rule, you can go to the screen of an issue and trigger the Bitbucket pipeline.
In this case, a new Test Execution would be created and linked back to the source Test Plan where the automation was triggered from
# References
- [GraphQL to JSON Body Converter](https://datafetcher.com/graphql-json-body-converter)
- [Jira Automation in Jira Cloud](https://support.atlassian.com/cloud-automation/docs/jira-cloud-automation/)
- [Jira smart values - issues](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-issues/)
- [Jira smart values - lists](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-lists/)
- [Jira smart values - text fields](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-text-fields/)
- [Jira smart values - users](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-users/)
- [Jira smart values - conditional logic](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-conditional-logic/)
- [Jira smart values - JSON functions](https://support.atlassian.com/cloud-automation/docs/jira-smart-values-json-functions/)
- Bitbucket Cloud
- [REST API for pipelines ](https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/pipelines/)
- [using variables in pipelines](https://support.atlassian.com/bitbucket-cloud/docs/variables-in-pipelines/)
- [integrating Jira Cloud and Bitbucket Cloud](https://support.atlassian.com/bitbucket-cloud/docs/integrate-jira-and-pipelines/)