Close

How to integrate JFrog pipelines with Jira and Bitbucket

Jeff Fry
Jeff Fry

Jeff Fry, Senior Technical Alliance Manager at JFrog

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  

Prerequisites

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 JiraRegister 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

  1. Go to https://bitbucket.org/jefffjfrog/atlassian-open-devops-tutorial
  2. Fork this repository to your Bitbucket workspace

Step 2: Set up JFrog pipelines for Jira

  1. Next, follow these instructions to create a Jira API Token
  2. Copy this Jira API Token
  3. In your JFrog Platform instance, set up the Jira integration by following these instructions
  4. Choose Jira for the Integration Type
  5. Call the Integration jiraForAtlassianTutorial
  6. Specify the Jira server API endpoint as the URL
  7. Specify your Jira User Name
  8. Paste your Jira API Token for Token
  9. Click Create to create the Jira integration
Jira integration

Step 3: Set up JFrog pipelines for Artifactory

  1. Create an Artifactory integration with the same instructions from Step 3
  2. Choose Artifactory for the Integration Type
  3. Call the Integration artifactoryForAtlassianTutorial
  4. Use the provided Artifactory URL and User name
  5. Generate an API key using the Get API Key button
  6. Click Create to create the Artifactory integration
Artifactory integration

Step 4: Set up JFrog pipelines for Bitbucket

  1. Follow these instructions to create a Bitbucket app password
  2. Copy your Bitbucket app password
  3. Create a Bitbucket integration with the same instructions from Step 4
  4. Choose Bitbucket for the Integration Type
  5. Call the Integration bitbucketForAtlassianTutorial
  6. Specify your Bitbucket User Name
  7. Paste your Bitbucket App password for Token
  8. Click Create to create the Bitbucket integration

Step 5: Build the example code

  1. In your JFrog Platform instance, add the example code by following these instructions using From YAML
  2. Specify bitbucketForAtlassianTutorial for the SCM Provider integration
  3. Specify /atlassian-open-devops-tutorial for the repository name
  4. Use the default values for the remaining fields
  5. Click Create Source 
  6. 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. 
  7. Go to your Jira project and view the new issue titled Atlassian tutorial failed build

Step 6: Fix the Dockerfile

  1. From your browser, go to your Bitbucket forked repository atlassian-open-devops-tutorial
  2. Edit the Dockerfile
  3. Delete the line that says “This line is not recognized and will cause the build to fail!”
  4. Commit this change and include the Jira issue number in the commit message
  5. 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

  1. Now go back to your Jira issue
  2. Notice that the ticket now references a build
  3. Click on the build
  4. 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.
  5. In JFrog Artifactory, click on the Issues tab in the build view.
  6. Notice that this issue is now referenced with this build
Build issue
Jeff Fry
Jeff Fry

Jeff Fry is an experienced principal engineer and cloud architect with a proven track record of working with partners to deliver innovative integrations.


Share this article

Recommended reading

Bookmark these resources to learn about types of DevOps teams, or for ongoing updates about DevOps at Atlassian.

Devops illustration

DevOps community

Devops illustration

DevOps learning path

Map illustration

Get started for free

Sign up for our DevOps newsletter

Thank you for signing up