GitHub の開発情報を Jira 作業項目にリンクする

作業項目キーを使用して開発データを Jira 作業項目にリンクする

To link your GitHub development data to Jira, you must add a Jira work item key to your commit message, branch name, or PR title.

1. 「DEV-2095」など、リンクするJira 作業項目のキーを探します。作業項目キーは、Jira ボードの作業項目カードまたは作業項目のナビゲーションにあります。

2. Check out a new branch in your repo, using the work item key in the branch name. For example, git checkout -b DEV-2095-<branch-name>.

3. When committing changes to your branch, use the work item key in your commit message. For example, git commit -m "DEV-2095 <summary of commit>".

4. When you create a pull request, use the work item key in the pull request title.

After you push your branch, you’ll see the pull request along with other development information in your Jira space.

If you use GitHub Actions, your workflows and deployments will be linked if a commit associated with the deploy contains the work item key in its commit message.

Read more about how to include work item keys in your development work.

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

When your team adds Jira work item keys to GitHub branches, commits, and pull requests, you’ll see development data in the following places:

• On Jira work items: the development panel updates automatically to show linked branches, pull requests, commits, builds, and deployments.

• Your Jira board: work item cards display icons to indicate when there is a linked branch, pull request, commit, build, or deployment.

• The Code tab: shows pull requests that have been linked to work items in your space within the last 30 days.

• The Releases tab: linked pull requests, builds, and deployments are shown for all the work items in your version.

• The Deployments tab: the deployments timeline shows all the deployments linked to your work items. How to link GitHub workflows and deployments to Jira.

• The Development page - shows pull requests that have been linked to work items in your space within the last 30 days. It also shows you development and security data other connected apps, key metrics, and proactive work suggestions, and your team’s related work in a single, actionable view. Read more information about Development in Jira.

• In Jira Query Language (JQL): you can search your space for work items that have commits, pull requests, builds, or deployments. For example, you could search for all the work items that are “Done” but have open pull requests. How to search using JQL.

• In automations: you can automate your workflows to transition work items when activity happens in your GitHub repos. For example, you might create a rule to automatically move work items to “in progress” when a new branch is created. Explore DevOps automation triggers.

Link to Jira work items in GitHub comments

GitHub コメント内のJira 作業項目にリンクするには、Jira 作業項目キーを角かっこで囲んで追加します。たとえば、GitHub のコメントに[DEV-2095]を追加すると、作業項目キーは自動的にJira 作業項目 DEV-2095 へのリンクに変わります。