管理者が Jira Softwareを開発ツールに接続させている場合、開発作業を Jira 課題と簡単に同期でき。コミットやブランチ、プル リクエストなどで課題キー (複数可) を参照すると、次のことが可能になります。

  • 課題の開発作業へのリンクを開発パネルに表示する
  • 検索のリスト ビューの開発列にある開発作業の詳細を表示する
  • 管理者が ワークフロー トリガーを設定している場合は、課題を新しいステータスに自動的に移行する
  • バージョンのリリースやトラッキングに使用されるバージョン詳細ページで、課題や開発作業を照合する

注意:課題キー(複数可)を参照すると、接続された開発ツールの方にも該当の JIRA 課題へのリンクが作成されます。

以下の表で、コミット、ブランチ、プル リクエスト、レビューで課題キーを参照する方法を説明します。いずれの場合も、課題キーは既定の Jira キーの書式に従っている必要があります。つまり、2 つ以上の大文字 ([A-Z][A-Z]+) にハイフンと課題番号が続きます。例: ABC-123

イベント
開発ツール
手順
コミットの作成Bitbucket、
GitHub、
GitHub Enterprise、
FishEye

コミットメッセージに課題キーを含めます。

たとえば、"TIS-1 最初のコミット" のようなコミットメッセージは、TIS-1 課題を「作業前」から「進行中」に自動的に移行します 。

ブランチの作成Bitbucket、
GitHub、
GitHub Enterprise、
FishEye

ブランチを作成する際に、課題キーをブランチ名に含めます。

たとえば、ブランチに "TIS-2 feature" と名前をつけると、 TIS-2 課題は「作業前」から「進行中」に自動的に移行します 。

マージプルリクエストの作成/再オープン/拒否Bitbucket、
GitHub、
GitHub Enterprise

少なくとも、次のいずれかの操作を行います:

  • コミット メッセージに課題キーがあるプルリクエストにコミットを含めます。コミットはマージコミットにならないことにご注意ください。
  • プルリクエストのタイトルに課題キーを含めます。
  • ソースブランチ名に課題キーが含まれていることを確認します。

たとえば、タイトルが "TIS-3 " のプルリクエストを作成すると、"TIS-3" 課題は「進行中」から「レビュー」に自動的にトランジションします 。プルリクエストを再オープン、却下、またはマージすると、それに応じて "TIS-3" 課題はトランジションします。

レビューの開始/拒否/廃棄/クローズCrucible

レビューを作成するときに、課題キーをレビュータイトルに含めます。

たとえば、レビューに "TIS- 4New story" という名前をつけて、レビューを開始すると、TIS-4 課題は「進行中」から「レビュー」に自動的にトランジションします。レビューを拒否、放棄、またはクローズすると、それに応じて "TIS-4" 課題はトランジションします。

ビルド計画の作成Bambooビルドのコミットの 1 つがコミットメッセージ内に JIRA 課題キーを含んでいる場合、ビルドは JIRA 課題に自動的にリンクされます。この機能を有効にするには、コミットに課題キーが含まれている必要があります。
デプロイメント プロジェクトの作成Bamboo

本番環境やテスト環境のような環境へのデプロイは、デプロイに関連したコミットのコミットメッセージに課題キーが含まれている場合に課題にリンクされます。この機能を有効にするには、コミットに課題キーが含まれている必要があります。

  • ラベルなし