SourceTree で JIRA 課題や GitHub や Bitbucket Cloud Issue と連動する方法

[#1]

SourceTree は、Bitbucket や GitHub と接続して、Git クライアントとしてローカルリポジトリとリモートリポジトリに対する操作を行うことができるわけですが、各サービスが備えている Issue Tracking (課題管理 / タスク管理) とも連動させることができます。

どういうことかというと、Git のコミットコメントにおいて、Issue ID を入力する「お作法」はみなさん、やっていると思います。その Issue ID を JIRA や、GitHub Issue, Bitbucket Issue へのハイパーリンクにしてくれるのです。

コミットメッセージ内の JIRA 課題 ID がハイパーリンクになります。ここからこの課題の詳細へ1クリックで飛べるわけです。

その部分だけ拡大しておきましょう。

SourceTree と JIRA Software の連動設定

では、設定方法を見ていきます。

SourceTree の画面右上の [設定] をクリックします。

次に、[高度な設定] タブをクリックします。

「コミット文字列の置換」が今回の設定箇所です。[追加]ボタンをクリックします。

JIRA の場合は、「置換タイプ」に「JIRA プロジェクトへのリンク」がありますので、これを選択します。

「プロジェクトプレフィックス」には、JIRA の課題キーを入力します。

「ホスティング URL」には、JIRA の URL を入力します。

はい、これだけです。これだけで、DEM-22 のような JIRA 課題 ID がハイパーリンクになります。

SourceTree と GitHub や Bitbucket Cloud の連動設定

まず、JIRA は Bitbucket、GitHub と連携することができます。したがって、JIRA と連携することで、上述の SourceTree と JIRA の連動設定しておけばよいと考えることもできます。実際に、GitHub Issue や Bitbucket Cloud Issue を使わずに JIRA で管理されているプロジェクトも多いです。JIRA と連携することで JIRA が持つ多くのメリットを享受することができるからです。

JIRA 課題とブランチ、コミット、プルリクエストが連動できるようになります。Bitbucket と連携の場合は、JIRA からブランチを作成することもできます。

さて、GitHub Issue、Bitbucket Issue との連動は少しコツが必要です。SourceTree では既定で、JIRA と Crucible (どちらも Atlassian 製品) との連動が設定しやすくなっています。「置換タイプ」に選択肢があるということです。それ以外は、「その他」として、正規表現パターンで設定をする必要があります。

（この画面に至る過程は、上述の「SourceTree と JIRA の連動設定」をご覧くださいませ）

あとは、GitHub のお作法に則り正規表現と置き換える URL を含むハイパーリンクの HTML タグを仕込みます。

正規表現パターン:

#(/d{1,})

置換文字列:

<a href="https://github.com/<user name>/<repository name>/issues/$1">#$1</a>

こんな感じでよいでしょう。

結果は、以下のようになります。

ハイパーリンクをクリックすれば、Issue がブラウザにて開きます。

Bitbucket Cloud Issue も同様です。

※この記事は、 https://www.evangelism.jp/articles/sourcetree-with-jira-github-issue/ の転載です。

[mune-ando]

MacでSourceTreeとRedmineとの連携をやってみました。SourceTreeのコミットメッセージの置換で

置換タイプ ： その他
正規表現パターン : #(\d+)
と置き換えます　:　<a href="https://[redmineのドメイン]/issues/$1">#$1</a>

とすると、コミットメッセージ内で正常にリンクで置換されるのですが、リンクをクリックするとブラウザが起動せずに、SourceTree内でRedmineの該当チケットが表示されてしまします。

何か、ブラウザを起動させる方法があるのでしょうか？

Windowsでは、メッセージの置換ではなくてリンクなのですね。Windowsでは無事にブラウザが起動してRedmineのチケットページが表示できています。