YouTrack

Issue tracking provider for JetBrains YouTrack.

  • About
  • Details
  • Release Notes
  • Installation

Ensure quality by linking with Issue Tracking

YouTrack allows teams to collaborate, coordinate changes, and track status. Using YouTrack with BuildMaster creates a toolchain of consistent, traceable steps, to help define process and deliver software with reliability.

Operations

Specific Issue Tracking operation added include:

  • Create YouTrack Issue - Creates an issue in YouTrack
  • Change YouTrack Issue State - Transitions issues in YouTrack from one status to another
  • Find YouTrack Issues - Queries TouTrack Issue IDs
  • Add Comment to YouTrack Issue - Adds a Comment to a YouTrack Issue from BuildMaster
  • Halt promotions - Will Halt a promotion when YouTrack issue of a specific status exists for the specified release

Using YouTrack with BuildMaster

Issue tracking is a cornerstone of the application release process and facilitates communication of specific features and issues. Integrating issue tracking, an already established process, into your DevOps toolchain is a key step deploying faster while maintaining compliance and traceability.

The steps below will outline a real-word example of how to utilize BuildMaster's YouTrack extension.

First you'll need to install the YouTrack Extension (version 5.6 or higher).

Administration > BuildMaster Extensions > YouTrack

Then create a Resource Credential to link BuildMaster to YouTrack.

Administration > Resource Credentials > Create Credential > YouTrack

Although the resource credential will work with a user name and password, it is recommended to create a permanent token.

Next, navigate to an application to associate it with a YouTrack project: click on Issues > Configure External Source > YouTrack Issue Source and fill in the appropriate fields.

We're using the Variable $ReleaseNumber so that we can tie issues in YouTrack to a release in BuildMaster without having to specify a single release.

Issues in BuildMaster should always be associated with a release. YouTrack however has no concept of a release, so the YouTrack issue source uses the Project and Fix version version fields in YouTrack to determine which issues to pull for a particular release. If your filter needs to be more complicated (multiple projects, different fields, etc) you can use a search query from the YouTrack dashboard.

When defining an issue source, you can use configuration variables and functions such as $ReleaseNumber. When run, these will be replaced with the appropriate value; for example if you have “ABlast” as the Project name and “v$ReleaseNumber” as the Fix for Version, and you’re viewing release 2.0 in BuildMaster, then the issue source will pull all issues the ABlast YouTrack project that have "v2.0" as their Fix for Version.

After manually configuring an issue source, any time you visit that application's overview page in BuildMaster, it will automatically refresh issues from that issue tracker. You can also manually refresh by going to Issues > Configure External Source > Manually refresh. Manually refreshing will also provide additional information like Execution Details including execution logs.

After configuring YouTrack as the issue source, the overview page of your application’s release will display all issues in YouTrack assigned to that release, regardless of YouTrack status.

You can also view all issues from the issues tab, regardless of release.

Step 2: Using BuildMaster and YouTrack together

Configuring an issue source in BuildMaster provides more functionality than increase visibility for the development teams. Additional useful capabilities are added once an issue source is configured.

Creating a Gate

First, we can put an Issues Resolved gate at the production (or staging) stage of your BuildMaster pipeline. This gate restricts a release package from moving forward unless every issue that is assigned to that release has a specific status (Done or Closed). This serves as a final check point, ensuring that every issue associated with this release has the appropriate status. In many cases ensure that a feature or bug is Done.

This can be done at any stage of a pipeline for any status that would be appropriate. This works as a check, but doesn’t make using an issue tracker any easier. We can also automate the stages that an issue travels through in BuildMaster.

Creating a New Issue

BuildMaster also allows you to create a YouTrack issue from within BuildMaster.

You can do this directly from within a deployment plan using the Create YouTrack issue operation.

Visual editor

Text Editor (OtterScript)

While monolithic deployment solutions are fast becoming a thing of the past, it doesn’t mean that the tools used to deploy a modern application in a DevOps environment should be isolated either. Integrations that make sense, increase visibility, and help automate manual tasks to create a stronger DevOps toolchain that allows organizations to expand and utilize established processes.

5.6.3

6/16/2017

No notes for this release

Download (requires BuildMaster 5.6.0 or newer)

5.6.2

6/15/2017

No notes for this release

Download (requires BuildMaster 5.6.0 or newer)

5.6.1

6/13/2017

No notes for this release

Download (requires BuildMaster 5.6.0 or newer)

5.6.0

4/17/2017
  • 3 - Convert to inedox-, add Issue Sources, Operations

Download (requires BuildMaster 5.6.0 or newer)

5.1.1

10/4/2016
  • 2 - Improve Issue Tracking with AnyProject Category

Download (requires BuildMaster 5.1.1 or newer)

5.1.0

6/17/2016

No notes for this release

Download (requires BuildMaster 5.1.0 or newer)

5.0.0

4/29/2016

No notes for this release

Download (requires BuildMaster 5.0.0 or newer)

4.1

2/15/2016
  • 1 - Use alternate endpoint if no project is selected

Download (requires BuildMaster 4.0.6 or newer)

4.0

11/15/2013

No notes for this release

Download (requires BuildMaster 4.0.6 or newer)

If your installation of BuildMaster can access inedo.com, simply navigate to Admin > Extensions, and install or update extensions from the gallery.

You can also manually install the extension.

  1. Copy the extension file (YouTrack.bmx) to the Extension Library path (by default, this is c:\BuildMaster\Extensions).
  2. Restart the BuildMaster Service (Admin > Service).
  3. Restart the BuildMaster Web Application (Admin > All Settings > Save).
  4. Verify that the new extension has been loaded (Admin > Extensions)