開発スペースで作業項目を参照する
管理者が Bitbucket Cloud、GitHub、GitLab、またはその他のサポートされている開発ツールに Jira を接続している場合に、作業項目とコードをシームレスに統合できます。
Atlassian Government 環境は Github 経由でのみ接続できます。
はじめる前に
Jira 管理者は、Bitbucket Cloud を Jira サイトに接続するか、GitHub を Jira サイトに接続するか、または別のサポートされた開発ツールを接続する必要があります。開発ツールとの統合に関する詳細をご確認ください。
チームの Jira スペースで [開発ツールを表示] スペース権限が必要です。スペース権限の詳細をご確認ください。
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 about work item keys.ブランチ名にキーを付けて、リポジトリで新しいブランチをチェックアウトします。たとえば、「
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>".プル リクエストを作成する際は、プル リクエストのタイトルにキーを使用します。
ツールにより Jira が認識されて同期されるようにするには、接続先のリポジトリに何らかをプッシュする必要があります。場合によっては、完全な同期が行われるまでに数分かかることがあります。
After you push your branch, you’ll see development information in your Jira work item.
プル リクエストのタイトルにキーを含めると、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.
Hover over an icon to view the details of the development activity, and go to your connected development tool.
開発アイコンは、次の場合に限り Jira ボードに表示されます。
ボード上の作業項目の少なくとも 1 つに開発データがリンクされている。
ボードに含まれる作業項目が 100 個未満である。
リンクされた開発情報を開発ページで表示するには、次の手順に従います。
スペースのナビゲーションで [開発] を選択します。
プル リクエスト サイクル期間、デプロイ頻度などのメトリックを、[主要指標] セクションで確認できます。
View details of work from apps connected to Jira, for example, pull requests and security vulnerabilities, under the Related work section.
See tailored, actionable recommendations that highlight work needing attention in the Work suggestions tab under the Related work section.
以下の条件を満たしていれば、開発ページで開発データを確認できます。
your space admins have enabled the Development feature for your space
開発アプリが接続され、データが Jira に流れている。
作業項目に影響を与える開発アクション
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. Discover ways to use 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 ツールでは既定で機能します。
Bamboo の場合、ビルドのいずれかのコミットでコミット メッセージにキーが含まれている場合、そのビルドは作業項目に自動的にリンクされます。この機能を有効にするには、コミットにキーが含まれている必要があります。
For Bitbucket Pipelines, simply include the key in the branch name. Find out 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 ツールでは既定の機能します。
デプロイメント
本番環境やテスト環境などの環境へのデプロイは、デプロイに関連付けられたコミットのコミット メッセージにキーが含まれている場合にリンクされます。この機能を有効にするには、コミットにキーが含まれている必要があります。
これは、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。
プル リクエスト
少なくとも、次のいずれかの操作を行います。
Include the work item key in the pull request title.
また、ソース ブランチ名がキーをそのブランチ名に含んでいることを確認します。
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.
レビュー
レビューを作成するときに、レビュー タイトルの先頭にキーを含めて、レビューを Jira 作業項目にリンクします。
たとえば、レビューに "JRA-123 <レビューの要約>" という名前を付けて、レビューを開始します。
これは、Jira を Crucible に接続した場合は既定で機能します。
この内容はお役に立ちましたか?