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

このページには、Jira インテグレーションで作業する際に遭遇する可能性のある一般的な問題のリストが含まれています。

GitLab は Jira のイシューにコメントできません。

GitLab が Jira イシューにコメントできない場合は、Jira インテグレーションに設定した Jira ユーザーに権限があることを確認してください：

  • Jira 課題にコメントを投稿します。
  • Jira 課題を移行します。

GitLab issue trackerが無効になっている場合、Jira issue の参照と更新コメントは機能しません。

Jira アクセス用の IP アドレスを制限している場合は、自己管理 IP アドレスまたはGitLab.com IP 範囲をJira の allowlist に追加してください。

GitLab が Jira イシューを閉じることができません。

GitLab が Jira イシューをクローズできない場合：

  • Jira 設定で設定したTransition ID が、プロジェクトがイシューを閉じるために必要なものと一致していることを確認してください。

  • Jira 課題がすでに解決済みとマークされていないことを確認してください：

    • Jira 課題の解決フィールドが設定されていないことを確認します。
    • イシューが Jira リストで取り消されていないか確認してください。

キャプチャ

CAPTCHA は何度か連続してログインに失敗するとトリガーされることがあり、Jira インテグレーションをテストする際に401 unauthorized エラーが発生することがあります。CAPTCHA がトリガーされた場合、Jira REST API を使用して Jira サイトで認証することはできません。

このエラーを修正するには、Jira インスタンスにサインインして CAPTCHA を完了します。

インポートしたプロジェクトで Jira インテグレーションが機能しません。

インポートされたプロジェクトで Jira インテグレーションが機能しないことがあるという既知のバグがあります。回避策として、インテグレーションを無効にしてから再度有効にしてください。

すべての Jira インテグレーションを Jira インスタンスレベルの値に一括変更します。

すべての Jira プロジェクトをインスタンスレベルのインテグレーション設定を使用するように変更します：

  1. Rails コンソールで以下を実行します：

    jira_integration_instance_id = Integrations::Jira.find_by(instance: true).id
Integrations::Jira.where(active: true, instance: false, inherit_from_id: nil).find_each do |integration|
  integration.update_attribute(:inherit_from_id, jira_integration_instance_id)
end

  2. UIからインスタンスレベルのインテグレーションを修正して保存し、すべてのグループレベルおよびプロジェクトレベルのインテグレーションに変更を反映させます。

Jira Cloud がリンクされているか確認します

Rails コンソールを使用して、Jira Cloud がリンクされているかどうかを確認できます：

指定された名前空間：

JiraConnectSubscription.where(namespace: Namespace.by_path('group/subgroup'))

指定されたプロジェクト：

Project.find_by_full_path('path/to/project').jira_subscription_exists?

任意の名前空間：

installation = JiraConnectInstallation.find_by_base_url("https://customer_name.atlassian.net")
installation.subscriptions

すべてのプロジェクトのサービスインテグレーションパスワードの一括更新

アクティブな Jira インテグレーションを持つすべてのプロジェクトの Jira ユーザーのパスワードをリセットするには、Rails コンソールで以下を実行します：

p = Project.find_by_sql("SELECT p.id FROM projects p LEFT JOIN integrations i ON p.id = i.project_id WHERE i.type_new = 'Integrations::Jira' AND i.active = true")

p.each do |project|
  project.jira_integration.update_attribute(:password, '<your-new-password>')
end

500 We're sorry GitLab で Jira イシューにアクセスする場合

GitLab で Jira 課題にアクセスすると、500 We're sorry. Something went wrong on our end エラーが発生することがあります。production.log に以下の例外が含まれていないか確認してください：

:NoMethodError (undefined method 'duedate' for #<JIRA::Resource::Issue:0x00007f406d7b3180>)

その場合は、インテグレーションされている Jira プロジェクトのイシューで期限フィールドが表示されていることを確認してください。

An error occurred while requesting data from Jira GitLab で Jira のイシューリストを見る場合

GitLab で Jira イシューリストを表示しようとすると、An error occurred while requesting data from Jira メッセージが表示されることがあります。

このエラーは、Jira インテグレーション設定の認証の詳細が不完全か、間違っている場合に表示されます。

このエラーを解決するには、インテグレーションを再度設定してみてください。認証の詳細が正しいことを確認し、API トークンまたはパスワードを再入力して、変更を保存します。