Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Since FlexDeploy 7.0.0.3, all FlexDeploy Jira integrations now support v3 of the Jira REST API. Users who opt into v3 will notice more accurate comments and descriptions when viewing Jira Work Items in FlexDeploy. You can begin utilizing v3 by updating the Jira REST API Pattern property on your Jira Integrations (e.g. /rest/api/3/issue/{JIRA_ISSUE}).

Creating an OAuth Token for FlexDeploy

  1. Go to Jira and login as the user you want to comment on Jira Issues with.

  2. Generate an API Token in Jira following this guide. ​

JIRA Issue Tracking Instances

A Jira instance looks like this:

Setting Up Folders and Projects to Use the JIRA Issue Tracking Instances

Then back in FlexDeploy, set up your folder ITS settings like this:

Linking JIRA Issues to FlexDeploy Builds

Now you are ready to link tickets with commits or by manually entering them on project builds or project packages.

Linking with Commit Messages

Set up your FlexDeploy Project’s Issue Tracking configuration with a work item pattern. The pattern must be Jira Project name + “-”. If your Jira project name is FLEXDEPLOY, then you can use FLEXDEPLOY-1234 in commit message as FLEXDEPLOY- would be setup as work item pattern.

Alternative you can always just prefix with # and not work item pattern configuration is necessary. For example include #FLEXDEPLOY-1234 in commit message and FLEXDEPLOY-1234 work item will be picked up during build.

Following this pattern, make a commit message.

Push and merge your change.

When you create a build, the issue numbers are pulled from your commits.

Linking by Manual Entry at Project Build Time

If you didn’t remember to put the issue number in your commit, and you are building the project manually, you can enter issue numbers at build time.

The issue number should be Jira Project Name-Issue Number

In this example, it’s FLEXDEPLOY.

Linking Issues to Project Packages

If you don’t put issue numbers in your commits and you are working with a package-based project, you can associate issues with packages that will live through its build and deployment lifecycle by following this pattern.

Go to the project and package which you wish to link a Jira Issue.

Edit the package.

Add one or more Issues. The dropdown only shows previously linked issues. Type the entire issue key to make a new one.

Save.

The issue number should be in the format Jira Project Name-Issue Number

Now, builds and deployments of this package will be associated to that Jira Issue.

  • No labels