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




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


Stash - JIRA Integration Checklist

If Stash and JIRA aren't playing nicely together, check the following list of questions to see if any of them apply to you.

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

Jira 5.0.4 以降integrates straight out-of-the-box with Stash.
Jira 4.3.0 - 5.0.3requires upgrading to a special version of the JIRA FishEye/Stash plugin in, see JIRA FishEye-Stash Plugin compatibility for details.
Jira 4.2.x 以前do not support Stash integration. You will need to upgrade to a newer version of JIRA. 

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

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

Have you created a two-way application link between Stash and JIRA?

Full integration between Stash and JIRA requires a reciprocated (two-way) application link between Stash and JIRA.

See Linking Stash with JIRA for instructions on how to create an application link. For full integration you must check the box marked " Also create a link from '<name of your JIRA server>' back to this server."enter your JIRA administrator credentials and then select your user base scenario to configure authentication.

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

  1. Go to Stash, click Administration > Application Links and make sure there is an application link entry for your JIRA server.
  2. Go to JIRA, click Administration > Application Links and make sure there is another application link entry pointing back to your Stash server.

Can your JIRA server and Stash server see each other on the network?

To check your applications can see each other, again go to Stash, click Administration > Application Links and check that there are no warnings at the top of the page. If you see a message similar to:

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

it means that Stash can no longer communicate with JIRA using the URL that was used when creating the application link.

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

After confirming Stash can see JIRA, you should then go to JIRA, click Administration > Application Links and check that there are no warnings for the application link targeting your Stash server. 

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

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

You must use an appropriate authentication mode (OAuth or Trusted Applications) for your application links. Trusted Applications can only be used if both of your servers are backed by the same user base (usually a Crowd or LDAP server, or when Stash is treating JIRA as a user server https://confluence.atlassian.com/display/JIRA044/Allowing+Other+Applications+to+Connect+to+JIRA+for+User+Management). If you have different sets of users in each server (or you're unsure) you should use OAuth.


  1. Go to the Stash "Administration" screen, select "Application Links"
  2. Jira アプリケーションのリンクについて、[内向き認証] および [外向き認証] 列の認証タイプを記録します。
  3. 内向きまたは外向きリンクでタイプが "なし" である場合、[設定] > [内向き認証] または [外向き認証] の順に選択して、上述のように OAuth または信頼済みアプリケーションを選択します。
  4. Go to the JIRA "Administration" screen, select "Application Links" and check that the "Outgoing Authentication" column matches the "Incoming Authentication" from the Stash administration, and vice-versa
  5. タイプに誤りがあるかタイプが "なし" である場合、ステップ 3 に従い、構成済みの内向き/外向き認証を変更します。

Note: if you are using Trusted Applications you will need to whitelist your Stash server's IP address in the Trusted Applications configuration for your Stash application link in JIRA. See Configuring Trusted Applications Authentication for more details.

Have you pushed to your Stash repository since creating your Application Links?

For performance reasons, Stash only starts scanning commit messages for JIRA issue keys after you've created a link to your JIRA server. On the first push after creating an application link, Stash will walk through your entire repository history, which may take a short period of time. After this process has completed, issue keys from your commit messages should show up in the Issues column on the commit list.

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

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


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

Is the JIRA FishEye plugin enabled in JIRA?

Some of the Stash integration features in JIRA piggyback off the JIRA FishEye plugin. To check whether the plugin is enabled:

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

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

If you're using a custom project key format in JIRA (as described in https://confluence.atlassian.com/display/JIRACOM/Configuring+Project+Keys) you will need to configure the regular expression Stash uses to look for issue key. See https://confluence.atlassian.com/display/STASHKB/Integrating+with+custom+JIRA+issue+key for details.

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

Versions of Stash prior to version 1.2.3 could experience issue key indexing problems if a plugin indexer threw an exception during the indexing process. Try upgrading to a newer version of Stash and following the guide at https://confluence.atlassian.com/display/STASHKB/Git+Commits+Are+Not+Linking+to+JIRA+Tickets+Due+to+Corrupted+Indexes to repair your repository index if symptoms persist.


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

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


Otherwise raise an issue in the Stash project and our legendary support staff will help you out.


最終更新日 2018 年 11 月 2 日




Powered by Confluence and Scroll Viewport.