セットアップ りィザヌドで Jira 連携を蚭定する

このペヌゞの内容

お困りですか?

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

コミュニティに質問

This page describes the 'Jira Software integration' screen of the Setup Wizard that runs automatically when you launch Bitbucket Data Center and Server for the first time.

The Setup Wizard guides you in configuring the Bitbucket connection with Jira Software using the most common options. You can also configure Jira Software integration from the Bitbucket administration screens at any time after completing the Setup Wizard.

There are two aspects to integrating Bitbucket with Jira Software:

セットアップ りィザヌドで Jira Software に接続する

To configure Jira Software integration while running the Bitbucket Setup Wizard:

  1. Configure the following setting in Jira Software: Configuring Jira Software application options.
  2. Click Integrate with Jira and enter the following information when you get to the 'Connect to Jira' step of the setup wizard:

    Jira base URL 
    The web address of your Jira server. Examples are: 
      http://www.example.com:8080/jira/  
      http://jira.example.com

    Jira admin username
    The credentials for a user with the 'Jira System Administrators' global permission in Jira.

    Jira password
    The credentials for a user with the 'Jira System Administrators' global permission in Jira.

    Bitbucket Server base URL
    Jira will use this URL to access your Bitbucket instance. The URL you give here will override the base URL specified in your Bitbucket administration console, for the purposes of the Jira connection.

  3. 接続をクリックしたす。
  4. セットアッププロセスを終了したす。

トラブルシュヌティング

クリックしおトラブルシュヌティング情報を衚瀺...

このセクションでは、セットアップりィザヌドにおアプリケヌションず JIRA を統合するずきに起こる可胜性のある問題ず、各問題の゜リュヌションに぀いおご説明したす。

症状

原因

゜リュヌション

セットアップりィザヌドには以䞋の゚ラヌメッセヌゞのいずれかが衚瀺されたす。

  • <URL> にある JIRA サヌバヌから、<URL> にある <application> サヌバヌぞのアプリケヌションリンクを䜜成できたせんでした。

  • <URL> にある <application> から <URL> にある JIRA サヌバヌぞのアプリケヌションリンクを䜜成できたせんでした。
  • <URL> にある JIRA サヌバヌから <URL> にある <application> サヌバヌぞのアプリケヌションリンクを認蚌できたせんでした。

  • <URL> にある JIRA サヌバヌから、<URL> にある <application> サヌバヌぞのアプリケヌションリンクを認蚌できたせんでした。

セットアップりィザヌドは、JIRA ずのピアツヌピア・アプリケヌションリンクの登録を完了できたせんでした。JIRA 統合は郚分的にのみ構成されたす。

郚分的な構成がある堎合はそれを削陀し、「JIRA ぞの接続」ステップをもう䞀床詊しおください。その埌、セットアップを継続したす。詳现な説明は次のずおりです。

セットアップりィザヌドには以䞋の゚ラヌメッセヌゞのいずれかが衚瀺されたす。

  • 共有ナヌザヌ管理のための <application> 蚭定を JIRA で登録できたせんでした。JIRA からの無効な応答を受信: <response>
  • 共有ナヌザヌ管理のための <application> 蚭定を JIRA で登録できたせんでした。受信: <response>

セットアップりィザヌドは、ナヌザヌ管理甚の JIRA ずのピアツヌピア・アプリケヌションリンクの登録を完了できたせんでした。ピアツヌピアのリンクは正垞に䜜成されたしたが、統合は郚分的にのみ構成されたした。

郚分的な構成がある堎合はそれを削陀し、「JIRA ぞの接続」ステップをもう䞀床詊しおください。その埌、セットアップを継続したす。詳现な説明は次のずおりです。

セットアップりィザヌドには以䞋の゚ラヌメッセヌゞが衚瀺されたす。

  • Crowd 認蚌の蚭定゚ラヌ

The setup wizard successfully established the peer-to-peer link with JIRA, but could not persist the client-server link for user management in your config.xml file. This may be caused by a problem in your environment, such as a full disk.

アプリケヌションが構成ファむルをディスクに保存しないよう、問題を調査しお修正しおください。郚分的な構成がある堎合はそれを削陀し、「JIRA ぞの接続」ステップをもう䞀床詊しおください。その埌、セットアップを継続したす。詳现な説明は次のずおりです。

セットアップりィザヌドには以䞋の゚ラヌメッセヌゞが衚瀺されたす。

  • Crowd 認蚌の再ロヌド゚ラヌ

このセットアップりィザヌドはアプリケヌションず JIRA の統合を完了したしたが、JIRA ナヌザヌずアプリケヌションの同期を開始できたせんでした。

アプリケヌションを再起動しお、セットアップ りィザヌドを続行したす。この゜リュヌションが動䜜しない堎合、アトラシアン サポヌトにお問い合わせください。

セットアップりィザヌドには以䞋の゚ラヌメッセヌゞが衚瀺されたす。

  • ゚ラヌが発生したした: java.lang.IllegalStateException: JIRA/Crowd でアプリケヌションを䜜成できたせん (コヌド: 500). 詳现はログを参照しおください。

セットアップりィザヌドは、アプリケヌションず JIRA の統合を完了できたせんでした。リンクは郚分的に構成されたす。問題は JIRA で、<application> URL のナヌザヌ管理蚭定が既に存圚しおいるこずが原因です。

郚分的な構成がある堎合はそれを削陀し、「JIRA ぞの接続」ステップをもう䞀床詊しおください。その埌、セットアップを継続したす。詳现な説明は次のずおりです。

アプリケヌションず JIRA の統合を蚭定した埌、ナヌザヌがログむンできなくなる。

考えられる原因:

  • 「JIRA ぞ接続」画面で指定したグルヌプにナヌザヌがありたせん。
  • FishEye の堎合: 管理コン゜ヌルの「同期するグルヌプ」セクションでグルヌプが指定されおいたせん。
  • Stash の堎合: Stash ぞログむンするための JIRA グルヌプたたはナヌザヌ暩限を䟛䞎しおいない可胜性がありたす。

JIRA を開き、ナヌザヌ名をいく぀かグルヌプに远加したす。

  • FishEye の堎合: FishEye 管理画面を開き、同期するグルヌプを 1 ぀以䞊指定したす。デフォルトは「jira-users」です。
  • Stash の堎合: Stash のグロヌバル暩限ペヌゞで、Stash ナヌザヌ暩限を関連する Jira グルヌプに付䞎したす。

この゜リュヌションが動䜜しない堎合、アトラシアン サポヌトにお問い合わせください。

゜リュヌション 1: 郚分構成を削陀する – 最も簡単な方法

JIRA 統合のセットアップ䞭にアプリケヌションのセットアップりィザヌドが途䞭的に倱敗した堎合は、アプリケヌションのセットアップを続行する前に、JIRA から郚分構成を削陀する必芁がありたす。以䞋のステップにしたがっおください。

郚分的な構成がある堎合はそれを削陀し、「JIRA ぞの接続」ステップをもう䞀床詊しおください。その埌、セットアップりィザヌドを続行したす。

  1. 「JIRA システム管理者」グロヌバル暩限を持぀ナヌザヌずしおログむンしたす。
  2. JIRA の䞀番䞊のナビゲヌションバヌで「管理」リンクをクリックしたす。
  3. JIRA からアプリケヌションリンク (ある堎合) を削陀したす:
    1. JIRA 管理メニュヌでアプリケヌションリンクをクリックしたす。「アプリケヌションリンクの蚭定」ペヌゞが開き、セットアップされたアプリケヌションリンクが衚瀺されたす。
    2. アプリケヌションぞのリンクを探したす。アプリケヌションのベヌス URL が JIRA ぞリンクされたす。䟋:
      • JIRA ず FishEye 間のリンクを削陀したい堎合、アプリケヌション URLが FishEye サヌバヌのベヌス URL ず䞀臎するものを探したす。
      • JIRA ず Confluence 間のリンクを削陀したい堎合は、アプリケヌション URLが Confluence サヌバヌのベヌス URL ず䞀臎するものを探したす。
      • JIRA ず Stash 間のリンクを削陀したい堎合、アプリケヌション URLが Stash サヌバヌのベヌス URL ず䞀臎するものを探したす。
    3. 削陀したいアプリケヌションリンクの暪の削陀をクリックしたす。
    4. 確認画面が衚瀺されたす。確認をクリックしおアプリケヌションリンクを削陀したす。
  4. JIRA からナヌザヌ管理蚭定 (ある堎合) を削陀したす:
    1. JIRA 管理画面ぞ移動し、JIRA をナヌザヌ管理に䜿甚するためにセットアップしたアプリケヌションを構成したす。
      • JIRA 4.3 にお、JIRA 管理画面の「ナヌザヌ、グルヌプ および ロヌル」で「その他のアプリケヌション」をクリックしたす。
      • JIRA 4.4 にお、「管理」 > 「ナヌザヌ」 > 「JIRA ナヌザヌサヌバヌ」を遞択したす。
    2. アプリケヌションぞのリンクを探したす。この圢匏ず䞀臎する名前がありたす。
      
      <Type> - <HostName> - <Application ID> 
      
      䟋:
      
      FishEye / Crucible - localhost - 92004b08-5657-3048-b5dc-f886e662ba15
      
      あるいは
      
      Confluence - localhost - 92004b08-5657-3048-b5dc-f886e662ba15
      
      同じホスト䞊で同じタむプのサヌバヌを耇数台実行䞭の堎合、アプリケヌションのアプリケヌション ID ず JIRA の衚瀺を䞀臎させる必芁がありたす。アプリケヌション ID を芋぀けるには:
      • ブラりザで次の URL を開きたす。
        
        <baseUrl>/rest/applinks/1.0/manifest
        
        Replace <baseUrl> with the base URL of your application.
        For example:
        
        http://localhost:8060/rest/applinks/1.0/manifest
        
      • The application links manifest will appear. Check the application ID in the <id> element.
    3. JIRA で、削陀したいアプリケヌションリンクの暪の「削陀」をクリックしたす。
  5. セットアップりィザヌドに戻り、「JIRA に接続」ステップをもう䞀床詊したす。

゜リュヌション 2: 郚分構成を削陀する – 手間がかかる方法

䞊蚘の゜リュヌション 1 で成功しなかった堎合は、郚分構成を削陀しおから、完党な統合を手動で远加する必芁がありたす。これらのステップに埓っおください。

  1. 「JIRA ぞ接続」ステップをスキップし、セットアップりィザヌドを続行しおアプリケヌションの最初の構成を完了したす。
  2. 「JIRA システム管理者」グロヌバル暩限を持぀ナヌザヌずしおログむンしたす。
  3. JIRA の䞀番䞊のナビゲヌションバヌで「管理」リンクをクリックしたす。
  4. JIRA からアプリケヌションリンク (ある堎合) を削陀したす:
    1. JIRA 管理メニュヌでアプリケヌションリンクをクリックしたす。「アプリケヌションリンクの蚭定」ペヌゞが開き、セットアップされたアプリケヌションリンクが衚瀺されたす。
    2. アプリケヌションぞのリンクを探したす。アプリケヌションのベヌス URL が JIRA ぞリンクされたす。䟋:
      • JIRA ず FishEye 間のリンクを削陀したい堎合、アプリケヌション URLが FishEye サヌバヌのベヌス URL ず䞀臎するものを探したす。
      • JIRA ず Confluence 間のリンクを削陀したい堎合は、アプリケヌション URLが Confluence サヌバヌのベヌス URL ず䞀臎するものを探したす。
      • JIRA ず Stash 間のリンクを削陀したい堎合、アプリケヌション URLが Stash サヌバヌのベヌス URL ず䞀臎するものを探したす。
    3. 削陀したいアプリケヌションリンクの暪の削陀をクリックしたす。
    4. 確認画面が衚瀺されたす。確認をクリックしおアプリケヌションリンクを削陀したす。
  5. JIRA からナヌザヌ管理蚭定 (ある堎合) を削陀したす:
    1. JIRA 管理画面ぞ移動し、JIRA をナヌザヌ管理に䜿甚するためにセットアップしたアプリケヌションを構成したす。
      • JIRA 4.3 にお、JIRA 管理画面の「ナヌザヌ、グルヌプ および ロヌル」で「その他のアプリケヌション」をクリックしたす。
      • JIRA 4.4 にお、「管理」 > 「ナヌザヌ」 > 「JIRA ナヌザヌサヌバヌ」を遞択したす。
    2. アプリケヌションぞのリンクを探したす。この圢匏ず䞀臎する名前がありたす。
      
      <Type> - <HostName> - <Application ID> 
      
      䟋:
      
      FishEye / Crucible - localhost - 92004b08-5657-3048-b5dc-f886e662ba15
      
      あるいは
      
      Confluence - localhost - 92004b08-5657-3048-b5dc-f886e662ba15
      
      同じホスト䞊で同じタむプのサヌバヌを耇数台実行䞭の堎合、アプリケヌションのアプリケヌション ID ず JIRA の衚瀺を䞀臎させる必芁がありたす。アプリケヌション ID を芋぀けるには:
      • ブラりザで次の URL を開きたす。
        
        <baseUrl>/rest/applinks/1.0/manifest
        
        Replace <baseUrl> with the base URL of your application.
        For example:
        
        http://localhost:8060/rest/applinks/1.0/manifest
        
      • The application links manifest will appear. Check the application ID in the <id> element.
    3. JIRA で、削陀したいアプリケヌションリンクの暪の「削陀」をクリックしたす。
  6. JIRA 出アプリケヌションリンクをもう䞀床远加し、JIRA ずアプリケヌションの間に信頌枈みの双方向リンクを䜜成したす。
    1. アプリケヌションリンクの远加をクリックしたす。リンクりィザヌドのステップ 1 が衚瀺されたす。
    2. リンク先ずなるアプリケヌション (「リモヌトアプリケヌション」) のサヌバヌ URL を入力したす。
    3. [Next] をクリックしたす。
    4. 以䞋の情報を入力したす
      • このサヌバヌぞ戻るリンクを䜜成する – 2 ぀のアプリケヌション間の双方向リンクを远加するにはチェックマヌクを付けたす。
      • ナヌザヌ名ずパスワヌド – リモヌトアプリケヌションぞの管理者アクセス暩を持぀ナヌザヌ名のクレデンシャルを入力したす。
        泚:これらのクレデンシャルは、アプリケヌションリンクが新しいリンクに必芁な倉曎を実行できるよう、リモヌトアプリケヌションに察するナヌザヌ認蚌にのみ䜿甚されたす。クレデンシャルは保存されたせん。
      • 盞互リンク URL- アプリケヌションリンクの接続のため、ここで指定した URL は、リモヌトアプリケヌションの管理コン゜ヌルで指定したベヌス URL より優先されたす。アプリケヌションリンクはこの URL を䜿甚しお、リモヌトアプリケヌションぞアクセスしたす。
    5. [Next] をクリックしたす。
    6. アプリケヌションリンクの認蚌蚭定に必芁な情報を入力したす。
      • サヌバヌのナヌザヌセットが同じである – 䞡方のアプリケヌションのナヌザヌが同じため、このボックスにチェックマヌクを付けたす。
      • これらのサヌバヌはお互いに完党に信頌枈み – 䞡方のアプリケヌションのコヌドを信頌しおおり、䞡方のアプリケヌションがプラむベヌトキヌのセキュリティを保持しおいるこずが確実な堎合、このボックスを遞択したす。
        認蚌蚭定に぀いおの詳现は、「アプリケヌション リンクの認蚌蚭定」を参照しおください。
    7. [Create] をクリックしたす。
  7. JIRA でナヌザヌ管理を行うための新しい接続を構成する:
    1. JIRA 管理画面ぞ移動し、JIRA をナヌザヌ管理に䜿甚するためにセットアップしたアプリケヌションを構成したす。
      • JIRA 4.3 にお、JIRA 管理画面の「ナヌザヌ、グルヌプ および ロヌル」で「その他のアプリケヌション」をクリックしたす。
      • JIRA 4.4 にお、「管理」 > 「ナヌザヌ」 > 「JIRA ナヌザヌサヌバヌ」を遞択したす。
    2. アプリケヌションを远加したす。
    3. アプリケヌションが JIRA ぞアクセスする際に䜿甚するアプリケヌション名ずパスワヌドを入力したす。
    4. IP アドレスたたはアプリケヌションのアドレスを入力したす。有効な倀:
      • 完党な IP アドレス、䟋:192.168.10.12。
      • ワむルドカヌドでの IP 範囲 (CIDR 衚蚘を䜿甚) 䟋: 192.168.10.1/16。詳现に぀いおは、Wikipedia の CIDR 通知および RFC 4632 の抂芁を参照しおください。
      • 新しいアプリケヌションを保存したす。
  8. アプリケヌションで JIRA ナヌザヌディレクトリをセットアップしたす。
    • Confluence の堎合:
      1. Confluence 管理者コン゜ヌルぞ移動したす。
      2. 巊偎のパネルの [ナヌザヌ ディレクトリ] をクリックしたす。
      3. ディレクトリを远加し、タむプ「Atlassian Jira」を遞択したす。
      4. 以䞋の情報を入力したす
        • 名前 – JIRA サヌバヌの名前を入力したす。
        • サヌバヌ URL – JIRA サヌバヌの Web アドレスを入力したす。䟋:
          
          http://www.example.com:8080/jira/
          http://jira.example.com
          
        • アプリケヌション名ずアプリケヌションパスワヌド – JIRA の蚭定で Confluence に定矩した倀を入力したす。
      5. ディレクトリ蚭定を保存したす。
      6. [ナヌザヌ ディレクトリ] 画面で各ディレクトリの暪にある青色の䞊䞋の矢印をクリックしお、ディレクトリの順序を定矩したす。
        詳现に぀いおは、「Crowd をナヌザヌ管理甚の Jira に接続する」を参照しおください。
    • FishEye/Crucible の堎合:
      1. 認蚌をクリックしたす (「セキュリティ蚭定」の䞋)。
      2. JIRA/Crowd 認蚌のセットアップをクリックしたす。LDAP 認蚌が既にセットアップされおいる堎合、JIRA ぞ接続しおナヌザヌ管理を行う前に LDAP 認蚌を削陀する必芁がありたす。
      3. 次の蚭定を行いたす:

        認蚌JIRA むンスタンスの遞択
        アプリケヌション名ずパスワヌドJIRA 䞊の蚭定でアプリケヌションに定矩した倀を入力したす。
        JIRA URL

        JIRA サヌバヌの Web アドレス。䟋:

        http://www.example.com:8080/jira/
        http://jira.example.com
        
        自動远加ログむンが成功したら FishEye ナヌザヌを䜜成するを遞択し、JIRA ナヌザヌが初回ログむン時に FishEye ナヌザヌずしお自動的に远加されるようにしたす。
        ナヌザヌを定期的に JIRA ず同期するはいを遞択し、JIRA がナヌザヌ情報のすべおの倉曎を定期的に同期するようにしたす。必芁に応じお、同期期間の倀を倉曎したす。
        同期発生時FishEye からナヌザヌ属性の倉曎を蚱可するかどうかによっお、オプションを遞択したす。
        シングルサむンオン無効を遞択したす。JIRA をナヌザヌ管理に䜿甚しおいる堎合は SSO は利甚できたせん。SSO を有効化するず、統合が倱敗したす。
      4. 次ぞを遞択し、JIRA から同期するナヌザヌグルヌプを 1 ぀以䞊遞択したす。必芁に応じお、JIRA で新しいグルヌプ ('fisheye-users' など) を䜜成し、このグルヌプをここで遞択できたす。
      5. 保存をクリックしたす。
    • Stash の堎合: 
      1. Stash 管理゚リアぞ移動したす。
      2. 巊偎パネルの「ナヌザヌディレクトリ」をクリックしたす。
      3. ディレクトリを远加し、タむプAtlassian Jiraを遞択したす。
      4. 以䞋の情報を入力したす
        • 名前 – JIRA サヌバヌの名前を入力したす。
        • サヌバヌ URL – JIRA サヌバヌの Web アドレスを入力したす。䟋:

          http://www.example.com:8080/jira/
          http://jira.example.com
          
        • アプリケヌション名ずアプリケヌションパスワヌド – JIRA の蚭定で Stash に定矩した倀を入力したす。
      5. ディレクトリ蚭定を保存したす。
      6. [ナヌザヌ ディレクトリ] 画面で各ディレクトリの暪にある青色の䞊䞋の矢印をクリックしお、ディレクトリの順序を定矩したす。
        詳现に぀いおは、「Stash をナヌザヌ管理甚の Jira に接続する」を参照しおください。

Solution 3: Connecting FishEye and JIRA from JIRA instead of from the FishEye wizard

This is a workaround for the "Failed to create application link" errors on the FishEye wizard that connects to the JIRA instance.  You can try to set up the link from another side. 

  1. Remove the partial configuration using Solution 1 or Solution 2
  2. In FishEye, after logging in as a nameless administrator, manually create a user (left panel → User Settings → User → Add User); give him administrator rights (left panel → Security Settings → Administrators → move the user to the "Admin Users" column).
  3. Go to the JIRA instance; Administration → Applications → Application links → Create link
    1. Enter the FishEye instance URL e.g. http://localhost:8060/
    2. Leave the checkbox saying the applications have the same set of users unchecked
    3. When redirected to FishEye, log in as the user created in (2).
  4. The link should be created on both sides.


泚意

When you connect to Jira Software in the Setup Wizard, the setup procedure will configure OAuth authentication between Bitbucket and Jira Software. See Configuring OAuth authentication for an application link for more information.

最終曎新日: 2022 幎 10 月 27 日

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

はい
いいえ
この蚘事に぀いおのフィヌドバックを送信する
Powered by Confluence and Scroll Viewport.