GitHub の開発情報を Jira 課題にリンクする

このドキュメントを読み終える頃には、GitHub のブランチ、コミット、プル リクエスト、ビルド、デプロイを Jira の課題に直接リンクし、チームの作業状況を把握しやすくする方法を理解できるでしょう。

GitHub の開発データを Jira にリンクするには、コミット・メッセージ、ブランチ名、PR タイトルに Jira 課題キーを追加する必要があります。

  1. リンクする Jira 課題の課題キー(「DEV-2095」など)を探します。課題キーは、Jira ボード上の課題カードまたは課題詳細ページのナビゲーションにあります。

  2. ブランチ名に課題キーを付けて、リポジトリで新しいブランチをチェックアウトします。例: git checkout -b DEV-2095-<branch-name>

  3. ブランチへの変更をコミットする際は、コミット メッセージに課題キーを付けます。例: git commit -m "DEV-2095 <summary of commit>"

  4. プル リクエストを作成する際は、プル リクエストのタイトルに課題キーを使用します。

ブランチをプッシュすると、Jira プロジェクトにプル リクエストとその他の開発情報が表示されます。

GitHub Actions を使用する場合、デプロイに関連するコミットのコミット・メッセージに課題キーが含まれていれば、ワークフローとデプロイがリンクされます。

開発作業に課題キーを取り入れる方法をご確認ください。

GitHub の開発データを Jira で表示する

チームが Jira 課題キーを GitHub のブランチ、コミット、プル リクエストに追加すると、次の場所に開発データが表示されます。

  • Jira 課題 - 開発パネルが自動的にアップデートされ、リンクされたブランチ、プル リクエスト、コミット、ビルド、デプロイが表示されます。

  • Jira ボード - リンクされたブランチ、プル リクエスト、コミット、ビルド、またはデプロイがある場合、課題カードにそれを示すアイコンが表示されます。

  • コード ページ - 過去 30 日以内にプロジェクトの課題にリンクされたプル リクエストが表示されます。

  • リリース ハブ - バージョン内のすべての課題について、リンクされたプル リクエスト、ビルド、デプロイが表示されます。

  • デプロイ機能 - デプロイ・タイムラインに、課題にリンクされているデプロイが表示されます。GitHub のワークフローとデプロイを Jira にリンクする方法

  • JQL - コミット、プル リクエスト、ビルド、またはデプロイのある課題をプロジェクトで検索できます。たとえば、「完了」したが未解決のプル リクエストがあるすべての課題を検索できます。JQL を使って検索する方法

  • 自動化 - GitHub リポジトリでアクティビティが発生したときに課題を移行するワークフローを自動化できます。たとえば、新しいブランチが作成されたときに、課題を自動的に「進行中」に移動するルールを作成できます。DevOps 自動化トリガーについて

Jira 課題の開発パネルを表示するには、「開発ツールの表示」というプロジェクト権限が必要です。プロジェクト権限のアップデート方法

GitHub のコメント内で Jira 課題にリンクするには、Jira 課題キーを角括弧で囲みます。たとえば、GitHub のコメントに [DEV-2095] を追加すると、課題キーは自動的に Jira 課題 DEV-2095 へのリンクに変わります。

さらにヘルプが必要ですか?

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