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

課題キーを使用して開発データを 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 自動化トリガーの詳細をご確認ください。

GitHub のコメントから Jira 課題にリンクする

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