Bitbucket Server と Jira をリンクする

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Bitbucket Server が Jira Software とリンクされている場合に得られるすべての連携機能については、「Jira 連携」を参照してください。

Jira Software を使用してユーザー管理を委任することもできます。「外部ユーザー ディレクトリ」を参照してください。

このページでは、Bitbucket Server を Jira Software にリンクする方法について説明します。

Bitbucket Server を Jira Software にリンクする

このページの内容

"アプリケーション リンク" を使用して、Bitbucket Server を Jira Software の 1 つ以上のインスタンスと連携できます。アプリケーション リンクは以下のいずれかによってセットアップします。

  • Bitbucket Server のインストール プロセス中にセットアップ ウィザードを使用する、または 
  • インストール後の任意のタイミングで以下の説明に従って実行する

Bitbucket Server を Jira Software サーバーにリンクさせる方法

  1. Bitbucket Server の管理領域の [設定] の [アプリケーション リンク] をクリックします。
  2. リンク先の Jira Software インスタンスの URL を入力し、[新しいリンクを作成] をクリックします。
  3. アプリケーション リンク ウィザードを完了し、Bitbucket Server を Jira Software サーバーに接続します。Jira Software から Bitbucket Server への自動リンクバックを使用して完全に連携する必要があります (システム管理者グローバル権限が必要です)。

注意:

  • アトラシアンでは、アプリケーション リンクに OAuth 認証のみを使用することを推奨しています。これは、このプロトコル固有のセキュリティを活用できるためです。信頼済みアプリケーションによる認証や BASIC 認証タイプは、現在では推奨していません。
  • Bitbucket Server 4.0 以降が Jira Software 6.2 以降とリンクされている場合、[課題の表示] 画面の下に [ソース] タブが表示されなくなります。 

  • Bitbucket Server は、Jira Software へのアプリケーション リンクを作成した後の最初のプッシュ時にのみ、コミット メッセージでの課題キーのスキャンを開始します。スキャンには少し時間がかかる場合があります。
  • Bitbucket Server では、以下のシステム プラグインを有効にする必要があります。これらは、Bitbucket Server 4.0 以降にバンドルされており、既定で有効になっています。

    • Atlassian ナビゲーションリンクプラグイン (com.atlassian.plugins.atlassian-nav-links-plugin) 
    • Bitbucket Server Dev Summary Plugin (bitbucket-jira-development-integration-plugin)。

詳細については、「アトラシアン アプリケーションをリンクして連携させる」を参照してください。

OAuth を使用するように既存のリンクを更新する

以下の場合は、OAuth を使用するように既存のアプリケーション リンクを更新する必要がある場合があります。

  • バージョン 5.2 以降のアプリケーション リンクを使用するバージョンにアトラシアン アプリケーションをアップグレードした場合。「アプリケーション リンクのバージョン マトリクス」を参照してください。
  • 既存のリンクは信頼済みアプリケーションの認証を使用しているが、チームは Jira Software 課題の開発パネルで Bitbucket Server などの開発者ツールからの要約情報を表示できない場合。
  • 既存のアプリケーション リンクが OAuth を使用しているが、チームは Jira Software 課題の開発パネルで詳細ダイアログを表示できない場合。
  • OAuth 認証タイプが必要なプラグインを使用している場合。

ここでは Jira Software での方法を説明しますが、他のアトラシアン サーバー製品でもプロセスはほとんど同じです。

ローカル アプリケーションの開始

ローカル アプリケーションの管理領域の [アプリケーション リンクの設定] ページに移動します。

更新が必要なリンクの横に DEPRECATED というマークが表示される場合があります。

更新するリンクの構成を編集するには、右側の鉛筆アイコンをクリックします。

[編集] ダイアログの [接続] 配下でリンクのローカル認証を設定します。

次のいずれかを選択します。

  • OAuth (両方のアプリケーションに異なるユーザーベースがある場合)
  • OAuth (偽装) (両方のアプリケーションが同じユーザーベースを共有している場合。多くの場合は LDAP を使用して外部ディレクトリで管理されます)

入力および出力方向の両方で、ローカルおよびリモート エンドの認証が一致していることを確認します。

[変更を保存] をクリックします。

リモート アプリケーションでの操作

リモート アプリケーションの管理領域の [アプリケーション リンクの設定] ページに移動します。表示している UI と一致する手順の列を選択します (いずれも同じ結果になります)。

更新するリンクの構成を編集するには、右側の鉛筆アイコンをクリックします。

[編集] ダイアログの [接続] 配下でリンクのローカル認証を設定します。

次のいずれかを選択します。

  • OAuth (両方のアプリケーションに異なるユーザーベースがある場合)
  • OAuth (偽装) (両方のアプリケーションが同じユーザーベースを共有している場合。多くの場合は LDAP を使用して外部ディレクトリで管理されます)

入力および出力方向の両方で、ローカルおよびリモート エンドの認証が一致していることを確認します。

[変更を保存] をクリックします。

更新中のアプリケーション リンクの [編集] をクリックします。

[設定] ダイアログで、[送信認証] をクリックして [OAuth] タブをクリックします。

[2-Legged OAuth の有効化] を選択します。ここでは、アプリケーションは異なるユーザーベースを持っていると想定しています。

両方のアプリケーションが同じユーザーベースを共有している場合 (一般に LDAP を使用して外部ディレクトリで管理されます)、必要に応じて [2-Legged OAuth (なりすまし機能あり) の有効化] を選択します。

[更新] をクリックします。

次に、[受信認証] をクリックしてから、[OAuth] タブをクリックします。


[2-Legged OAuth の有効化] を選択します。ここでは、アプリケーションは異なるユーザーベースを持っていると想定しています。

両方のアプリケーションが同じユーザーベースを共有している場合は、任意で [2-Legged OAuth (なりすまし機能あり) の有効化] を選択します。

[更新] をクリックします。

注意:

  • Jira Software の開発パネルの要約データを表示できるユーザーが、その要約に集約される、詳細ダイアログの各情報 (ブランチ、コミット、プル リクエストなど) の閲覧権限を持っていない場合があります。これは、詳細ダイアログが、接続されたアプリケーションでそのユーザーが持っているアクセス権限を尊重しているためです。

  • 開発パネルを表示するには、チーム メンバーが Jira Software で "開発ツールの表示" 権限を持っている必要があります。

  • Jira Software とアトラシアン開発者ツール (Bitbucket Server、Bamboo、Crucible、Fisheye) 間のアプリケーション リンクでは、信頼済みアプリケーションによる認証および Basic 認証が無効化されている必要があります。

  • ポート 443 でアプリケーションを実行する場合、すべての機能を利用するには、有効な SSL 証明書 (自己署名証明書ではありません) を使用する必要があります。

詳細は、「アプリケーション リンク用の OAuth セキュリティ」を参照してください。

Jira Software との連携での制限事項

  • プル リクエストを表示する場合などの Jira Software 課題の詳細の表示は Jira 5.0 の REST API に依存しています。Bitbucket Server が Jira Software バージョン 5.0 よりも前のバージョンと連携している場合、課題詳細は表示されません。
  • 課題のトランジションには OAuth 認証が必要です。アプリケーション リンクに Basic 認証のみが使用されている場合、ユーザーは課題詳細を表示できますが、課題をトランジションできなくなります。
  • Jira Software の権限は尊重されるため、課題のトランジションを実行する権限がないユーザーには Bitbucket Server でもトランジション ボタンは表示されません。
  • Bitbucket Server が複数の Jira Software インスタンスとリンクしており、複数のプロジェクトに同じキーが設定されている場合、PRIMARY とマークされているインスタンスの課題のみが表示されます。詳細は、「同じアプリケーション タイプへの複数のリンクに対してプライマリ リンクを決定する」を参照してください。

Bitbucket Server を Jira Software Cloud にリンクする

Bitbucket Server を Jira Software Cloud にリンクする場合、ポート制限や、その他の考慮事項があります。 

ローカル サーバーは有効な SSL 証明書を使用し、ポート 80 または 443 でアクセス可能である必要があります。詳細は、こちらの Atlassian Cloud 製品ドキュメントを参照してください。

If you have a internet-facing firewall, make sure to allow the IP range used by Atlassian to reach your internal network. For up-to-date information on that, see Atlassian cloud IP ranges and domains.

Jira Software との連携のトラブルシューティング

Bitbucket Server と Jira Software の連携では、エラーが発生したり、期待どおりに機能しなかったりする場合があります。

課題内で開発パネルを表示できない

開発パネルを表示するには、Jira Software で "開発ツールの表示" 権限を持っている必要があります。「グローバル権限を管理する」を参照してください。

プロジェクトへのアクセス権限がない

Jira Software 内で対象のプロジェクトにアクセスする権限がない場合、Bitbucket Server は課題を表示できません。

Jira Software サーバーのバージョンがサポートされていない

Bitbucket Server は Jira 4.3.x 以降と連携できます。一部の機能では、正常に作動するために Jira Software の上位バージョンが必要となります。詳細は、「Bitbucket Server とアトラシアン アプリケーションの連携」を参照してください。

課題キーが無効

Bitbucket Server doesn't check for invalid issue keys, such as 'UTF-8'. An error will result if Bitbucket Server tries to connect to an issue that doesn't exist. See this issue:  STASH-2470 - Getting issue details... STATUS

課題キーがカスタム形式

Bitbucket Server assumes that issue keys are of the default format (that is, two or more uppercase letters ([A-Z][A-Z]+), followed by a hyphen and the issue number, for example TEST-123). By default, Bitbucket Server will not recognize custom issue key formats. See Using custom Jira issue keys with Bitbucket Server for details.

アプリケーション リンクが OAuth でのみ作成され、信頼済みのアプリケーションを使用するリンクの作成オプションがない

Bitbucket Server は、"管理者" グローバル権限を持つユーザーには OAuth のアプリケーション リンクの作成のみを許可します。信頼済みアプリケーションの認証を使用してアプリケーション リンクを作成するには、"システム管理者" 権限を持つユーザーとしてログインする必要があります。

引き続きお困りの場合

Jira Software と Bitbucket Server に関連する詳細情報については、「Jira Software 連携のトラブルシューティング」を参照してください。

アプリケーション リンクを使用したアトラシアン製品の連携で問題がありましたか?

アプリケーション リンクに関するトラブルシューティング ガイド」をご用意しました。アプリケーション リンクをセットアップするうえでエラーや問題が発生している場合、こちらをご覧ください。

最終更新日 2019 年 3 月 4 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.