仕事で使用しているRedmine（一人チケット管理だけど）とBitbucketのレポジトリとの連携の設定をしてみます。やってみると、つまづいた点がありましたので、メモとして残しておきます。

参考にしたのは以下のサイトです。

Redmine.JP Blog

Redmine 1.4新機能紹介: チケットとリビジョンの関連づけの追加・削除

http://blog.redmine.jp/articles/new-feature-1_4/manage-issue-relations/

Redmineのブログサイトです。

Redmine.JP

Redmineとバージョン管理システムの連携

http://redmine.jp/tech_note/subversion/

RedmineをSubversion等各種バージョン管理ツールと連携する手順です。

Redmineの公式サイトです。

Qiita

RedmineとGitHubを連携 – Qiita

https://qiita.com/n_slender/items/54cd282c140fadbbb322

チケット管理はRedmine、ソース管理はGithubでやっていたのですが、チケットとコミットの関連付けが欲しくなったので、RedmineとGitHubを連携させることにしました。よくあるネタです…

今回行った手順を簡単に説明すると以下の通りです。コマンドなどの詳細の手順は各サイトをご覧ください。

1. Redmineにredmine_github_hookプラグインをインストールする。
2. RedmineのサーバーにBitbucketリポジトリからmirrorリポジトリでcloneしておく。そのときgit remoteは、後で認証が面倒になるのでhttpsではなくsshで指定しておく。cloneはredmineのアカウントで行う。
3. Bitbucketリポジトリからfetchできるように、Redmineのサーバーでredmineのアカウントでssh-genkeyでパスワード無しで公開キー、秘密キーを作成する。公開キーをBitbucketに登録しておく。実際にfetchできるかテストしておく。
4. Redmineでリポジトリの設定をする。設定はRedmine全体の設定とプロジェクト個別のリポジトリの設定がある。設定できたらプロジェクトのリポジトリが参照できるか見てみる。サイトが今どきUTF-8ではなくシフトJISだからリビジョンの差分が文字化けしてしまうので、全体の設定-ファイル（どういう訳かリポジトリではない）で、添付ファイルとリポジトリのエンコーディングをutf-8,cp932,euc-jpに設定しなければいけない。差分を表示をインラインにすると文字化けするが、横に並べるにすると正常に表示される（これは不明）。また、リポジトリが大きいとプロジェクトのリポジトリのページはInternal Errorになるが、しばらくすれば参照できる（これで最初諦めかけた・・・）。
5. BitbucketのリポジトリのWebhooksの設定をして、commitするとredmineのレポジトリが更新されるようにしておく。何かcommitしてBitbucketにpushすると、Redmineのレポジトリが更新されるかを確認する。
6. 連携する前のRedmineの各チケットとリビジョンと関連付けを行う。

以上は各サイトの内容をいいどころ取りしたものです。それぞれ自分のサイトに合わせて設定してください。

以上ですと、Redmineからレポジトリを参照できるだけですので、BitbucketとSourceTreeでも使いやすいようにRedmineの連携も設定します。

BitbucketからRedmineのチケットIDとリンクするには、リポジトリの設定のリンクで

Link URL: https://[redmineのドメイン]/issues/\1
Link Key : #(\d+)

とします。これでBitbucketページ内で#チケット番号をクリックすれば、Redmineの該当する番号のチケットページが表示します。

同様にSourceTreeの設定-詳細で、コミットメッセージ中のリンクで

置換タイプ　:　その他
正規表現　：　(\d+)
リンク先 URL　:　https://[redmineのドメイン]/issues/$1

と設定すると、コミット内のメッセージに出てくる#チケットIDをクリックすれば、Redmineの該当する番号のチケットページが表示できるようになります。

実現できなかったことは、Redmine内のレポジトリのハッシュからBitbucketのコミットにリンクの方法でした。何かよりRedmineのブラグインがあるのでしょうか？

改訂2版 わかばちゃんと学ぶ Git使い方入門

著:湊川あい, 著:DQNEO

¥2,208 （2025/04/08 19:27時点 | Amazon調べ）

Amazon

ポチップ

独習Git

著:リック・ウマリ, 翻訳:吉川邦夫

¥3,247 （2025/04/08 19:27時点 | Amazon調べ）

Amazon

ポチップ

いちばんやさしいGit&GitHubの教本 第2版 人気講師が教えるバージョン管理＆共有入門 「いちばんやさしい教本」シリーズ

著:横田紋奈, 著:宇賀神みずき

¥2,178 （2025/04/08 19:27時点 | Amazon調べ）

Amazon

ポチップ

追記（2020年5月7日）

RedmineとSourceTreeの連携ですが、以上はWindowsの設定方法です。Macの場合は違います。リンク先ではなく置換される文字列となりますので、HTMLのリンクとなります。例えば、以下のようになります。

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

ただし、自分のところではブラウザが起動せずに、そのままのビューでRedmineになってしまいます。何かまだ問題がありそうです。

Atlassian Community

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

https://community.atlassian.com/t5/Sourcetree-articles/SourceTree-で-JIRA-課題や-GitHub-や-Bitbucket-Cloud-Issue-と連動する方法/ba-p/619934

SourceTree は、Bitbucket や GitHub と接続して、Git クライアントとしてローカルリポジトリとリモートリポジトリに対する操作を行うことができるわけですが、各サービスが備えている Issue Tracking (課題管理 / タスク管理) とも連動させることができます。 どういうことかというと、Git のコミットコメントにおいて、Issue ID を入力する「お作法」はみなさん、やっていると思います。その Issue ID を JIRA や、GitHub Issue, Bitbucket Issue へのハイパーリンクにしてくれるのです。 コミットメッセージ内の J…

追記（2020年9月30日）

あれからBitBucketをやめて、QNAPのContainer StationにGitLabをコンテナで立てました。上記の記事中のgit remoteは、sshではなくHTTPSでアクセスさせています。

QNAPのファームウェアをアップデートして再起動したら、RedmineとGitLabの連携がうまくいかなくなりました。

いろいろと調べてみると、Redmineからgit pullができていませんでした。原因は、GitLabのコンテナのIPアドレスが違うアドレスになっていて、RedmineからGitLabのコンテナにアクセスできなくなっていたのが原因でした。たまたま今までQNAPを再起動してもGitLabのコンテナのIPアドレスが変わらなかったようでした。まあ、考えてみると当たり前です。~/.ssh/configで直接IPアドレスを指定していたのが敗因でした。

そこで、~/.ssh/configを

Host gitlab                                                                                                                                                                                       
  Hostname gitlab_web_1     # アクセスできるホスト名                                                                                                                                                                      
  # Hostname 172.29.0.3    直接IPアドレスをしているのはやめる。                                                                                                                                                                       
  IdentityFile ~/.ssh/id_rsa                                                                                                                                                             
  User git 

のようにコンテナのホスト名に変更しておきました。これで、GitLabのコンテナを再起動しても大丈夫のはずです。git remoteのほうは、

$ git remote -v                                                                                                                           
origin  git@gitlab:user-name/xxx.git (fetch)                                                                                                                                                      
origin  git@gitlab:user-name/xxx.git (push)   

のようにしています。

ちなみにRedmineとGitLabのコンテナは同じネットワークに存在してます。これが重要でう。

追記（2021年7月7日）

BitbucketからGitlabに移行したけど、設定方法は基本的に同じです。

Redmineのサーバーでredmineアカウントで公開キー/秘密キーを作成してGitlabのサーバーに公開キーを登録しないといけないということを忘れて手こずりました。