GitHub and YouTrack 4.1: Even better (and smoother)

GitHub offers a series of hooks when using YouTrack for issue management, which makes integration easier. This is not new, and in fact we’ve discussed it before. What is new, however, is support for commit linking, and the fact that until the recent release ofYouTrack 4.1, all the configuration had to be done on the GitHub side. And while the integration does work as designed and allows us to apply commands directly from commits, the settings page and steps for configuring the service hooks can be somewhat confusing, to say the least.

In-place Configuration

All configuration now takes place directly in YouTrack’s UI. Open your project’s Administration page and select the GitHub tab:image


From here you can add new GitHub repositories, and configure the possibility of commit linking and applying commands from commit messages.

Commit links

With a commit link, we can get from:imagedirectly to here:imageThat is, we can go directly to the commit from the YouTrack issue. In order to enable this functionality, we click on the Add GitHub repository link under GitHub tab, specify the connection data to connect to our GitHub repository, which is the login, password and the actual repository. Nothing else is required.image

If you’re not the owner of the repository, but you have read access, you can select the checkbox Show Repositories for another owner and get a list of those.

Applying Commands

One of YouTrack’s powerful features is the ability to apply commands to tasks, and what’s more, allow these commands to be provided either via the User Interface or during a commit message. For instance, we can write #SDA-2135 Fixed in the commit message of a check-in and have YouTrack automatically mark an issue as fixed. This is a feature that the GitHub hook provides and has been available in the past. The difference now is that we can now configure this from YouTrack, and more easily than via GitHub. In order to do so, in the same dialog box for configuring the repository, we select the Committer group:imageCommitters are actual user groups in YouTrack. With the GitHub integration service enable, YouTrack will search the specified group for a committer. By default, All Users is set as committers, but we strongly recommend that you select a particular group. It’s just more efficient, specially when you have a large number of users. We do need to remember that a user account between GitHub and YouTrack is paired based on the email address. If a match is not found, the command will not be applied.

(If you want to access repositories you do not own, for applying commands you need write access to them)

imageWith support for commit links and easier configuration for applying commands, we’re hoping to integrate YouTrack with GitHub even more smoothly. Get the latest YouTrack 4.1 now and as always, let us know if you like it and what else you’d like to see!


Comments below can no longer be edited.

8 Responses to GitHub and YouTrack 4.1: Even better (and smoother)

  1. Avatar

    Thomas Freudenberg says:

    November 9, 2012

    Awesome, except that you don’t use OAuth. It’s 2012, don’t ask for my GitHub credentials.

    • Avatar

      QS says:

      November 15, 2013

      Amen. That was my first thought, too. Ridiculous.

  2. Avatar

    Basil says:

    November 11, 2012

    Is it possible to only reference an issue, without a command?
    This commit for example does not show up with the associated issue my-project-1:
    Fixed stuff

    • Avatar

      Anna Zhdan says:

      November 12, 2012

      Hello, Basil!
      Try using command “comment”, where command is expected, that means, that you only want to add comment. Same thing works for YouTrack web UI.

      • Avatar

        Basil says:

        November 16, 2012

        This works, thanks!
        Will it ever be possible to just reference the id?

        • Avatar

          Anna Zhdan says:

          November 16, 2012

          Currently referencing issue id without any command means, that you want this issue to be fixed. And we are not going to change it now.

  3. Avatar

    Matt says:

    February 14, 2013

    I am struggling to understand what, if any, integration there is between YouTrack issues and GitHub issues. Is there information on this?

Discover more