GitHub の開発情報を Jira 作業項目にリンクする
このドキュメントを読み終える頃には、GitHub のブランチ、コミット、プル リクエスト、ビルド、デプロイを Jira の作業項目に直接リンクし、チームの作業状況を把握しやすくする方法を理解できるでしょう。
作業項目キーを使用して開発データを Jira 作業項目にリンクする
GitHub の開発データを Jira にリンクするには、コミット メッセージ、ブランチ名、PR タイトルに Jira 作業項目キーを追加する必要があります。
「DEV-2095」など、リンクするJira 作業項目のキーを探します。作業項目キーは、Jira ボードの作業項目カードまたは作業項目のナビゲーションにあります。
ブランチ名に作業項目キーを含めて、リポジトリで新しいブランチをチェックアウトします。たとえば、
git checkout -b DEV-2095-<branch-name>のようにします。ブランチへの変更をコミットする際は、コミット メッセージに作業項目キーを含めます。たとえば、
git commit -m "DEV-2095 <summary of commit>"などとします。プル リクエストを作成する際は、プル リクエストのタイトルに作業項目キーを使用します。
ブランチをプッシュすると、Jira スペースにプル リクエストとその他の開発情報が表示されます。
GitHub Actions を使用する場合、デプロイに関連するコミットのコミット メッセージに作業項目キーが含まれていれば、ワークフローとデプロイがリンクされます。
開発作業に作業項目キーを含める方法の詳細については、こちらをご確認ください。
GitHub の開発データを Jira で表示する
チームが Jira 作業項目キーを GitHub のブランチ、コミット、プル リクエストに追加すると、次の場所に開発データが表示されます。
Jira 作業項目: 開発パネルが自動的に更新され、リンクされたブランチ、プル リクエスト、コミット、ビルド、デプロイが表示されます。
Jira ボード: リンクされたブランチ、プル リクエスト、コミット、ビルド、またはデプロイがある場合、作業項目カードにそれを示すアイコンが表示されます。
[コード] タブ: 過去 30 日以内にスペースの作業項目にリンクされたプル リクエストが表示されます。
[リリース] タブ: バージョン内のすべての作業項目について、リンクされたプル リクエスト、ビルド、デプロイが表示されます。
[デプロイ] タブ: デプロイ タイムラインに、作業項目にリンクされているすべてのデプロイが表示されます。GitHub のワークフローとデプロイを Jira にリンクする方法については、こちらをご確認ください。
[開発] ページ: 過去 30 日以内にスペースの作業項目にリンクされたプル リクエストが表示されます。また、接続されている他のアプリの開発データとセキュリティ データ、主要なメトリック、プロアクティブな作業の提案、チームの関連作業が実用的な単一のビューで表示されます。Jira での開発の詳細については、こちらをご確認ください。
Jira クエリ言語 (JQL): コミット、プル リクエスト、ビルド、またはデプロイがある作業項目をスペースで検索できます。たとえば、「完了」したが未解決のプル リクエストがあるすべての作業項目を検索できます。JQL を使用して検索する方法については、こちらをご確認ください。
自動化: ワークフローを自動化して、GitHub リポジトリでアクティビティが発生したときに作業項目をトランジションできます。たとえば、新しいブランチが作成されたときに、作業項目を自動的に「進行中」に移動するルールを作成できます。DevOps 自動化トリガーについては、こちらをご確認ください。
Jira の作業項目で開発パネルを表示するには、スペース権限 "開発ツールの表示" が必要です。スペース権限の更新方法については、こちらをご確認ください。
GitHub のコメントから Jira 作業項目にリンクする
GitHub コメント内のJira 作業項目にリンクするには、Jira 作業項目キーを角かっこで囲んで追加します。たとえば、GitHub のコメントに[DEV-2095]を追加すると、作業項目キーは自動的にJira 作業項目 DEV-2095 へのリンクに変わります。
この内容はお役に立ちましたか?