Link GitHub development information to Jira work items
By the end of this doc, you’ll know how to link GitHub branches, commits, pull requests, builds, and deployments directly to Jira work items, giving your team greater visibility of the status of their work.
作業項目キーを使用して開発データを 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.
「DEV-2095」など、リンクするJira 作業項目のキーを探します。作業項目キーは、Jira ボードの作業項目カードまたは作業項目のナビゲーションにあります。
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>.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>".When you create a pull request, use the work item key in the pull request title.
ブランチをプッシュすると、Jira プロジェクトにプル リクエストとその他の開発情報が表示されます。
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.
[コード] タブ - 過去 30 日以内にプロジェクトの作業項目にリンクされたプル リクエストが表示されます。
[リリース] タブ - バージョン内のすべての作業項目について、リンクされたプル リクエスト、ビルド、デプロイが表示されます。
[デプロイ] タブ - デプロイ タイムラインに、作業項目にリンクされているデプロイが表示されます。GitHub のワークフローとデプロイを Jira にリンクする方法をご確認ください。
In JQL - you can search your project 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
You must have the project permission “View Development Tools” to see the Development panel in Jira work items. How to update project permissions
Link to Jira work items in GitHub comments
GitHub コメント内のJira 作業項目にリンクするには、Jira 作業項目キーを角かっこで囲んで追加します。たとえば、GitHub のコメントに[DEV-2095]を追加すると、作業項目キーは自動的にJira 作業項目 DEV-2095 へのリンクに変わります。
この内容はお役に立ちましたか?