セットアップ ウィザードで Jira 連携を設定する

Bitbucket Server と Jira をリンクする

このページの内容

お困りですか?

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

コミュニティに質問

このページでは、初めて Bitbucket Server を起動したときに自動的に実行される Bitbucket Server セットアップ ウィザードの [Jira Software 連携] 画面について説明します。

セットアップ ウィザードはもっとも一般的なオプションを使用して Bitbucket Server と Jira Software との接続構成を案内します。セットアップ ウィザードを完了した後、いつでも Bitbucket Server 管理画面から Jira Software 連携を構成できます。

Bitbucket Server と Jira Software の連携には 2 つの側面があります。

 

このページの内容:

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

Bitbucket Server セットアップ ウィザードの実行中に Jira Software 連携を構成する方法

  1. Jira Software で次の設定を構成します: 「Jira Software アプリケーション オプションの構成
  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 Server instance. The URL you give here will override the base URL specified in your Bitbucket Server 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. 作成をクリックします。
  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 に接続する」を参照してください。

注意

セットアップ ウィザードで Jira Software に接続すると、セットアップ手順で Bitbucket Server と Jira Software との間のOAuth 認証が構成されます。詳細については、「アプリケーション リンク用に OAuth 認証を設定する」を参照してください。

最終更新日: 2019 年 2 月 11 日

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

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