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 のサポート対象バージョンを使っていますか?

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

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

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.

問題が続く場合

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

• "There is no application type 'stash' installed." when trying to create an application link
• <リポジトリ名> がインデックス中で 2 つめのインデックス リクエストが無視される
• Application Link (Source tab via OAuth) fails in JIRA after Stash upgrade
• Application Link between Stash and JIRA fails due to systems clock not being synchronized
• No application link found with the id でアプリケーション リンクに失敗する
• 赤いバナーの string error でアプリケーション リンクに失敗する
• Application Stash seems to be offline in JIRA after creating an application link to Stash
• アプリケーション リンクを作成できない。入力した URL からレスポンスが返されなかった
• 課題を表示できない
• Capabilities Warning Applications with flagged capabilities may be offline or older versions
• 信頼済みアプリケーション リンクを構成する際の CertificateTooOldException
• Connecting Stash to JIRA for User Management Fails
• アップグレード後にリポジトリへのプッシュやブランチ権限の管理に失敗する
• インデックス破損により Git コミットが Jira チケットにリンクされない
• コミット タブの課題列に Jira の課題キーへのリンクが表示されない
• Jira 課題のソース タブに関連ソースなしと表示される
• Jira のソース タブが動作していない
• アプリケーション リンクで OAuth タブしか表示されない
• アプリケーション リンク作成時の Oracle 例外: setCharacterStream
• Problem creating an Application Link from JIRA to a HTTPS Stash (or vice-versa)
• Stash does not link commit to JIRA after setting custom JIRA issue key regex
• Stash HTTPS request is redirecting back to HTTP URL during application links creation
• 信頼済みアプリケーション認証の IPv6 例外

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