Reference work items in your development projects
Enjoy the seamless integration of work items and code when your admin has connected Jira to Bitbucket Cloud, GitHub, GitLab, or other supported developer tools.
Atlassian Government 環境は Github 経由でのみ接続できます。
はじめる前に
Your Jira admin needs to either connect Bitbucket Cloud to your Jira site, connect GitHub to your Jira site, or connect another supported development tool. Find out more about integrating with development tools.
You must have the View development tools project permission in your team’s Jira project. Find out more about project permissions.
To reference Jira work items while committing, building, and deploying code with Bitbucket, GitHub, or other supported developer tools:
Find the key for the Jira work item you want to link to, for example “JRA-123”. You can find the key in several places in Jira:
• On the board, work item keys appear at the bottom of a card.
• On the work item’s details, keys appear in the breadcrumb navigation at the top of the page.
Find out more about work item keys.Check out a new branch in your repo, using the key in the branch name. For example,
git checkout -b JRA-123-<branch-name>.When committing changes to your branch, use the key in your commit message to link those commits to the development panel in your Jira work item. For example,
git commit -m "JRA-123 <summary of commit>".When you create a pull request, use the key in the pull request title.
ツールにより Jira が認識されて同期されるようにするには、接続先のリポジトリに何らかをプッシュする必要があります。場合によっては、完全な同期が行われるまでに数分かかることがあります。
After you push your branch, you’ll see development information in your Jira work item.
Including the key in the title of your pull request will automatically create a link to Jira.
Not seeing anything? Make sure you’ve formatted the Jira work item key correctly using capital letters. For example, “JRA-123”, not “jra-123”.
Jira で開発情報を表示する
To view linked development information in a Jira work item:
Navigate to the work item.
[開発] で、追加情報を表示する件のプル リクエスト、ブランチ、またはコミットの数を選択します。
リンクされた開発情報を Jira ボードで表示するには、次の手順に従います。
ボードに移動する
Check for development icons on the work item cards to see whether there are pull requests, branches, commits, or deployments linked to your work.
カーソルをアイコンに合わせて開発アクティビティの詳細を表示し、クリック スルーして接続されている開発ツールに移動します。
開発アイコンは、次の場合に限り Jira ボードに表示されます。
At least one of the work items on your board has development data linked to it.
Your board contains less than 100 work items.
Development actions that affect your work items
The following actions in your development environment will link and update your work items in Jira. More actions are available if your Jira admin has enabled smart commits. Learn more about using smart commits.
ブランチ
Include the work item key in the branch name when you create the branch to link it to your Jira work item.
例: git checkout -b JRA-123-<branch-name>
これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise、Fisheye ツールでは既定の機能します。
If you’re using Bitbucket Cloud, GitHub or GitLab, you can create a branch directly from your Jira work item. Under Development, select Create branch. If you create a branch this way, the key is automatically added to the name of the branch.
ビルド
ビルド情報は、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。
For Bamboo, a build is automatically linked to a work item if one of the build's commits includes the key in its commit message. The key must be included in the commit to activate this feature.
For Bitbucket Pipelines, simply include the key in the branch name. Learn more about Bitbucket Pipelines.
変更を確認できる「コミット」
Include the work item key in the commit message to link the commit to your Jira work item.
例: git commit -m "JRA-123 <commit message>"
これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise、Fisheye ツールでは既定の機能します。
デプロイメント
A deployment to an environment, such as production or testing, is linked if a commit associated with the deploy contains the key in its commit message. The key must be included in the commit to activate this feature.
これは、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。
プル リクエスト
少なくとも、次のいずれかの操作を行います。
Include the work item key in the pull request title.
Ensure that the source branch name also includes the key in the branch name.
Bitbucket Cloud only: include a commit in the pull request that has the key in the commit message (the commit cannot be a merge commit).
If you create the pull request from the development panel in a Jira work item, the key is added automatically.
レビュー
Include the key at the beginning of the review title when you create the review to link the review to your Jira work item.
たとえば、レビューに "JRA-123 <レビューの要約>" という名前を付けて、レビューを開始します。
これは、Jira を Crucible に接続した場合は既定で機能します。
この内容はお役に立ちましたか?