How to integrate JFrog pipelines with Jira and Bitbucket
Step-by-step instructions on how to create JFrog pipelines with Bitbucket and Jira
Time
10 minute read
Audience
You work on projects within Jira and want to track the progress of bugs and features in your software builds.
Prerequisite
You have a Jira account and a Jira project. Get started with Jira here.
You have created a Bitbucket Cloud account. Login or get started with Bitbucket here.
You have access to your JFrog Cloud instance. Register for an account here.
You have installed the JFrog Platform: Artifactory App for Jira. Register for an account here.
You have followed the instructions to configure your JFrog Cloud instances with the app and tested the connectivity
You're familiar with the basics of Jira issues, Bitbucket, and JFrog
Step 1: Get the example code
Go to https://bitbucket.org/jefffjfrog/atlassian-open-devops-tutorial
Fork this repository to your Bitbucket workspace
Step 2: Set up JFrog pipelines for Jira
Next, follow these instructions to create a Jira API Token
Copy this Jira API Token
In your JFrog Platform instance, set up the Jira integration by following these instructions
Choose Jira for the Integration Type
Call the Integration jiraForAtlassianTutorial
Specify the Jira server API endpoint as the URL
Specify your Jira User Name
Paste your Jira API Token for Token
Click Create to create the Jira integration
Step 3: Set up JFrog pipelines for Artifactory
Create an Artifactory integration with the same instructions from Step 3
Choose Artifactory for the Integration Type
Call the Integration artifactoryForAtlassianTutorial
Use the provided Artifactory URL and User name
Generate an API key using the Get API Key button
Click Create to create the Artifactory integration
Step 4: Set up JFrog pipelines for Bitbucket
Follow these instructions to create a Bitbucket app password
Copy your Bitbucket app password
Create a Bitbucket integration with the same instructions from Step 4
Choose Bitbucket for the Integration Type
Call the Integration bitbucketForAtlassianTutorial
Specify your Bitbucket User Name
Paste your Bitbucket App password for Token
Click Create to create the Bitbucket integration
Step 5: Build the example code
In your JFrog Platform instance, add the example code by following these instructions using From YAML
Specify bitbucketForAtlassianTutorial for the SCM Provider integration
Specify <your username>/atlassian-open-devops-tutorial for the repository name
Use the default values for the remaining fields
Click Create Source
After a few seconds, JFrog Pipelines will attempt to build the example application in your atlassian-open-devops-tutorial repository. It will fail due to an issue with the Dockerfile.
Go to your Jira project and view the new issue titled Atlassian tutorial failed build
Step 6: Fix the Dockerfile
From your browser, go to your Bitbucket forked repository atlassian-open-devops-tutorial
Edit the Dockerfile
Delete the line that says “This line is not recognized and will cause the build to fail!”
Commit this change and include the Jira issue number in the commit message
JFrog Pipelines will attempt to build the example application in your atlassian-open-devops-tutorial repository again. But this time it will succeed.
Step 7: View the fix in Jira and JFrog Artifactory
Now go back to your Jira issue
Notice that the ticket now references a build
Click on the build
This will bring up a dialog that shows the JFrog pipeline and the build number. You can click on this to be taken directly to the build in JFrog Cloud.
In JFrog Artifactory, click on the Issues tab in the build view.
Notice that this issue is now referenced with this build
