ビルド ワークフローが JIRA に存在し、共通ステータスとトランジションが組み込まれています（詳細については、以下の「ビルド ワークフローの理解」セクションを参照してください）。

• JIRA および Bamboo に慣れていない場合は、既存のワークフローの編集は些細なタスクではないため、ビルド ワークフローを使用することをお勧めします。
• ビルド ステータスとトランジションを含めるように変更したい既存のワークフローがある場合、ビルド ワークフローをコピーして編集することをお勧めします。
• Bamboo トランジションを既存のワークフローに統合する場合、ワークフローを編集してトランジションを追加することができます。JIRA ワークフローについてよくわからない場合は、これを行わないことをお勧めします。

ビルド ワークフローの理解

プロジェクトでのビルド ワークフローの使用

以下の手順では、ビルド ワークフローを使用するワークフロー スキームを作成し、そのワークフロー スキームをプロジェクトに関連付ける方法を説明します。ビルド ワークフローを既存のワークフロー スキームに追加する場合、以下のステップ4～6を無視し、代わりに既存のワークフロー スキームにワークフローを割り当てます。

方法

1.ビルド ワークフローを使用するワークフロー スキームの作成

1. サイト管理者としてログインします。
2. JIRA 管理コンソールで、ワークフロー > ワークフロー スキームに移動します。ワークフロー スキーム ページが表示されます。
3. ワークフロー スキームの追加 をクリックします。 
4. ワークフロー スキームの名前と説明を入力し、追加をクリックします。ワークフロー スキームが作成され、ワークフローを編集するためのページが表示されます。
5. ワークフローの割り当てをクリックします。 
6. 課題タイプ ドロップダウンで、ビルド ワークフローを適用する課題タイプを選択します。ワークフロー ドロップダウンで、ビルド ワークフローを選択します。追加をクリックします。 

2.ワークフロー スキームとプロジェクトの関連付け

1. 「 JIRA 管理者 」グローバル権限を持つユーザーとしてログインします 。

2. 「プロジェクト概要」ページに移動します。キーボード ショートカット：「g」 + 「g」 +「projects」と入力

3. 「プロジェクト概要」ページの左側のワークフローをクリックします（画面中央の「ワークフロー」セクションの詳細リンクをクリックすることもできます）。「ワークフロー」ページが表示され、プロジェクトで使用されている現在のワークフロー スキームが示されます。

4. スキームの切り替えをクリックすると「プロジェクトへのワークフロー スキームの関連付け」ページが表示されます。

5. スキーム リストから関連するワークフロー スキームを選択し、関連付けをクリックして、移行プロセスを開始します。ワークフロー スキームによって、ビルド ワークフローがプロジェクトに関連付けられます。
6. 同意するをクリックしてプロセスを終了します。 
7. ビルド ワークフローと共に使用するプロジェクトを選択します。 

（ワークフロー スキームで指定した課題タイプの）課題がビルド ワークフローを使用するようになりました。コミット時に課題の課題キーをコミット メッセージに追加すると、ビルドが開始/成功/失敗するときに、課題は自動的にワークフローに沿ってトランジションします。

ビルド ワークフローの編集

ビルド ワークフロー自体は編集不可のため、編集することができません。ただし、元のビルド ワークフローがプロジェクトのに0図にあっていない場合、コピーしてそのコピーを編集することができます。ワークフロー スキームに追加して、そのスキームをプロジェクトに関連付けることで、新しい（コピーした）ワークフローをアクティブ化することができます。

ビルド ワークフローのコピーと編集

1. サイト管理者としてログインします。
2. JIRA 管理コンソールで、スキーム > ワークフロー スキームに移動します。ワークフロー スキーム ページが表示されます。
3. すべてのワークフローの表示をクリックします。 
4. ビルド ワークフローを見つけて、「操作」列のコピーをクリックします。
5. 新しい（コピーされた）ワークフロー スキームの名前と説明を入力し、コピーをクリックします。新しいワークフローが作成され、「ワークフローの表示」ページが表示されます。
6. 必要に応じて新しいワークフローを編集してアクティブ化できるようになりました。この方法の詳細については、「ワークフローの設定」と「ワークフローのアクティブ化」を参照してください。

カスタム ワークフローへのビルド トランジションの統合

プロジェクトでビルド ワークフローのコピーの編集ができない場合は、Bamboo トランジションを含めるように既存のワークフローを手動で編集することができます。JIRA ワークフローについてよくわからない場合は、これを行わないことをお勧めします。

ビルド トランジションを既存のカスタム ワークフローに統合するには、ワークフローを編集し、以下のように、適切な課題ステータスと課題トランジションを設定します。

課題ステータスの設定

課題に関連するビルドがビルド中またはビルドが失敗したことを示す課題ステータス（「ビルド中」、「ビルド失敗」など）をワークフローに設定することをお勧めします。中間ステータスなしで Bamboo 固有のビルド トランジションを JIRA ワークフローに組み込むことを妨げる技術的な制約はありませんが、実際には問題の原因となります。

たとえば、開発者が課題に取り組んでおり、その課題について、数日の間に何度かコミットしたとします。
以前のコミットでビルドが成功した場合でも、開発者が課題に関する作業を完了していない場合があり、課題を解決するビルドを成功させず、より多くのコードをコミットする必要があります。そのため、中間状態 (「ビルド中」など) が必要になります。これは、課題を特定のビルドから解決させたい場合にのみ、開発者が課題をトランジションさせる状態です (#build コミット コマンドを使用)。

課題トランジションの設定

ビルドによる自動課題トランジションは、コミット コマンドと、以下のような JIRA の Bamboo 固有トランジション プロパティによって制御されます。

• コミット コマンド — コミット コマンドはトランジション名にマップされます。そのため、「ビルド待機中」トランジションをワークフローに追加する場合、ユーザーは、コミット メッセージで #wait または #wait-for-build  コミット コマンドを使用することで、トランジションを自動的にトリガーできます。

• Bamboo 固有トランジション プロパティ — Bamboo ビルドが成功または失敗した場合にトリガするトランジション上の Bamboo 固有トランジション プロパティ。以下のプロパティがサポートされます。

  プロパティ	値	説明
  build.passed.transition	すべて	このプロパティを持つトランジションは、この課題のビルドが成功したときにトリガされ、現在の状態の課題にトランジションすることができます。
  build.failed.transition	すべて	このプロパティを持つトランジションは、この課題のビルドが失敗したときにトリガされ、現在の状態の課題にトランジションすることができます。
  build.passed.resolution	有効な解決状況、例：「修正済み」	このプロパティを持つトランジションがビルドによってトリガされると、課題の解決状況がこのプロパティで指定されたものに設定されます。

   JIRA で一般的なトランジション プロパティを設定できないことに注意してください。追加する各トランジションのトランジション プロパティを手動で再入力する必要があります。