Bitbucket Server - Jira 連携のチェックリスト

Bitbucket Server と Jira の間の挙動がおかしい場合、次の質問一覧で該当するものがあるかどうかをご確認ください。

Jira のサポート対象バージョンを使っていますか?

当社のアプリケーション リンクのトラブルシューティング ガイドはご確認いただいていますか?

アプリケーション リンクのトラブルシューティング ガイドをご確認ください。これは、アプリケーション リンク固有のあらゆる問題を解決できるように作成された専用ガイドです。アプリケーション リンクで何らかのエラーが発生している場合はこのガイドでソリューションを見つけることができます。

Bitbucket Server と Jira の間に双方向のアプリケーション リンクを作成済みですか?

Bitbucket Server と Jira の間の完全な連携には、Bitbucket Server と Jira の間に双方向 (2 方向) のアプリケーション リンクが必要です。

アプリケーション リンクの作成方法については「Bitbucket を Jira にリンクする」をご確認ください。完全な連携を行うには、[<Jira サーバー名> からこのサーバーへのリンクを作成する] チェックボックスを選択し、Jira 管理者の資格情報を入力し、ご利用のユーザー基盤のシナリオを選択して認証を構成する必要があります。

すでに双方向のアプリケーション リンクをセットアップ済みかどうかは次の手順で確認できます。

1. Bitbucket Server に移動し、[管理] > [アプリケーション リンク] の順にクリックして、ご利用の Jira サーバー用のアプリケーション リンクのエントリがあることを確認します。
2. Jira に移動し、[管理] > [アプリケーション リンク] の順にクリックして、Bitbucket Server インスタンスをポイントしている別のアプリケーション リンクのエントリがあることを確認します。

Jira サーバーと Bitbucket Server のインスタンスはネットワーク上で互いに到達できますか?

アプリケーション同士が互いを認識できるかどうかを確認するには、Bitbucket Server に移動し、[管理] > [アプリケーション リンク] に移動して、ページ上部に警告が表示されていないことを確認します。次のようなメッセージが表示されることがあります。

"Application 'JIRA Server' seems to be offline. Click here to Relocate."

これは、Bitbucket Server がアプリケーション リンクの作成時に利用された URL を利用して Jira と通信できなくなっていることを意味します。

• Jira サーバーが移動している場合は "Relocate" リンクをクリックして再配置ウィザードに進む必要があります。 
• URL が適切である場合は、ネットワーク構成や、ご利用の Jira サーバーが実行中であることをご確認ください。

Bitbucket Server から Jira を確認できるのを確認したら、Jira に移動し、[管理] > [アプリケーション リンク] に移動して、Bitbucket Server インスタンスを宛先とするアプリケーション リンクで警告が表示されていないことを確認します。 

両方のアプリケーション リンクの構成ページに警告が表示されていない場合、ご利用のサーバーで互いを認識できています。

ご利用のアプリケーション リンクは適切に認証されていますか?

アプリケーション リンクでは適切な認証モード (OAuth または信頼済みアプリケーション) を利用する必要があります。信頼できるアプリケーションは、両方のサーバーが同じユーザー基盤 (通常は Crowd または LDAP サーバー、あるいは Bitbucket Server が Jira をユーザー基盤として扱っている場合: https://ja.confluence.atlassian.com/display/JIRA044/Allowing+Other+Applications+to+Connect+to+JIRA+for+User+Management) を利用している場合にのみ利用できます。各サーバーで一連の別のユーザーを利用している (あるいは構成内容が不明な) 場合は OAuth を利用します。

確認方法: 

1. Bitbucket Server の [管理] 画面に移動して [アプリケーション リンク] を選択します。
2. Jira アプリケーションのリンクについて、[内向き認証] および [外向き認証] 列の認証タイプを記録します。
3. 内向きまたは外向きリンクでタイプが "なし" である場合、[設定] > [内向き認証] または [外向き認証] の順に選択して、上述のように OAuth または信頼済みアプリケーションを選択します。
4. Jira の [管理] 画面に移動し、[アプリケーション リンク] を選択して、[外向き認証] の列が Bitbucket Server の管理画面の [内向き認証] に一致すること、およびその逆の確認を行います。
5. タイプに誤りがあるかタイプが "なし" である場合、ステップ 3 に従い、構成済みの内向き/外向き認証を変更します。

注意: 信頼済みアプリケーションを利用している場合、Jira 内の Bitbucket Server のアプリケーション リンク用に、信頼済みアプリケーションの構成画面で Bitbucket Server インスタンスの IP アドレスを許可リストに含める必要があります。詳細については「認証用に信頼済みアプリケーションを構成する」をご確認ください。

アプリケーション リンクの作成以降、Bitbucket Server のリポジトリへのプッシュを行っていますか?

Bitbucket Server が行うコミット メッセージの Jira 課題キーのスキャンは、パフォーマンスの問題のため、Jira サーバーへのリンクの作成後にのみ開始されます。アプリケーション リンクの作成後の最初のプッシュが行われると、Bitbucket Server によってリポジトリ履歴全体の確認が行われます。これには少し時間がかかる可能性があります。このプロセスが完了すると、コミット メッセージ内の課題キーがコミット一覧の課題列に表示されるようになります。

Jira で課題ソース タブの表示 (バージョン制御の表示) 権限をユーザーに付与していますか? 

課題ソース タブの表示 (Jira 5.2+) またはバージョン制御の表示 (Jira 5.1.1 以前) 権限を持っているユーザーのみが、Jira でソース タブ表示できます。Jira 権限の構成方法については https://ja.confluence.atlassian.com/display/JIRA/Managing+Project+Permissions をご確認ください。

ご利用のサーバー同士で日時は同期されていますか?

サーバー時刻が同期されていない場合、認証に失敗する可能性があります。詳細については「アプリケーション リンクで信頼済みアプリケーションの認証を構成するときの CertificateTooOldException」をご確認ください。

Jira で Jira Fisheye プラグインは有効化されていますか?

Jira での Bitbucket Server 連携機能の一部は Jira Fisheye プラグインの機能を利用します。このプラグインが有効化されているかどうかを確認するには、次の手順を実行します。

1. Jira に移動し、[管理] > [アドオンの管理] (以前の Jira バージョンの場合は [管理] > [プラグイン]) の順にクリックします。 
2. [システム プラグインの表示] をクリックします。
3. Fisheye Plugin が有効化されていることを確認します。
4. すべての必須プラグイン モジュールが有効化されていることを確認します。

Jira でカスタムの課題キー形式を利用していますか?

Jira でカスタムのプロジェクト キー形式を利用している場合 (https://ja.confluence.atlassian.com/display/JIRACOM/Configuring+Project+Keys を参照)、Bitbucket Server で課題キーを見つけるための正規表現を構成する必要があります。詳細については https://ja.confluence.atlassian.com/display/BitbucketServerKB/Integrating+with+custom+JIRA+issue+key をご確認ください。

インストール済みのカスタム プラグインはありますか?

バージョン 1.2.3 よりも前の Bitbucket Server では、インデックス プロセス中にプラグイン インデクサーで例外が返されたときに、課題キーのインデックス作成のパフォーマンスの問題が発生することがあります。Bitbucket Server の新しいバージョンにアップグレードし、症状が続く場合は https://ja.confluence.atlassian.com/display/BitbucketServerKB/Git+Commits+Are+Not+Linking+to+JIRA+Tickets+Due+to+Corrupted+Indexes のガイドを利用してリポジトリ インデックスを修復してください。

問題が続く場合

このページの子記事で、発生している症状に一致しているものがあるかどうかをご確認ください。

• アプリケーション リンクを作成しようとしたときに "アプリケーション タイプ 'bitbucket' はインストールされていません。" と表示される
• <リポジトリ名> がインデックス中で 2 つめのインデックス リクエストが無視される
• Bitbucket Server へのアプリケーション リンクの作成後、Jira でアプリケーション Bitbucket Server がオフラインであると表示される
• Bitbucket Server のアップグレード後、Jira のアプリケーション リンク (OAuth 経由のソース タブ) に失敗する
• システム クロックが同期されていないため、Bitbucket Server と Jira の間のアプリケーション リンクに失敗する
• No application link found with the id でアプリケーション リンクに失敗する
• 赤いバナーの string error でアプリケーション リンクに失敗する
• カスタム Jira 課題キーの正規表現の設定後に Bitbucket Server でコミットが Jira にリンクされなくなった
• アプリケーション リンクの作成中、Bitbucket Server の HTTPS リクエストが HTTP の URL にリダイレクトされる
• アプリケーション リンクを作成できない。入力した URL からレスポンスが返されなかった
• 課題を表示できない
• Capabilities Warning Applications with flagged capabilities may be offline or older versions
• 信頼済みアプリケーション リンクを構成する際の CertificateTooOldException
• Bitbucket Server を Jira に接続してユーザーを管理するのに失敗する
• Bitbucket Server を他のアトラシアン製品と連携する際のエラー
• アップグレード後にリポジトリへのプッシュやブランチ権限の管理に失敗する
• Getting "Invalid OAuth credentials" when registering a Jira Software Cloud site in Bitbucket Data Center
• インデックス破損により Git コミットが Jira チケットにリンクされない
• How to retrieve the commits associated with Jira issue keys in Bitbucket Server and Data Center.
• Incorrect Bitbucket URL displayed in Jira Cloud after creating Bitbucket Server staging environment from production
• Bitbucket Server でカスタム Jira 課題キーに連携する
• コミット タブの課題列に Jira の課題キーへのリンクが表示されない
• Jira issue keys do not display the issue in Bitbucket Server
• Jira 課題のソース タブに関連ソースなしと表示される
• Jira のソース タブが動作していない
• アプリケーション リンクで OAuth タブしか表示されない
• アプリケーション リンク作成時の Oracle 例外: setCharacterStream
• Jira から HTTPS の Bitbucket Server (あるいは逆方向) にアプリケーション リンクを作成する際の問題
• 信頼済みアプリケーション認証の IPv6 例外
• User cannot create issues in Jira from Bitbucket Server/Datacenter after upgrade to Jira 9.x

あるいは、Bitbucket Server プロジェクトに課題を起票していただければ、当社のサポート スタッフがお手伝いします。