成果物の共有
ジョブ間での成果物の共有
アーティファクトの依存関係を使用して、さまざまなステージのジョブ間でアーティファクトを共有できます。たとえば、ビルドで受け入れテストを実行して、WAR を毎回再構築せずに同じ WAR をジョブ間で共有するとします。
アーティファクトが後続のジョブと共有されるたびに、ジョブのエージェントにコピーされます。
異なるステージにある 2 つのジョブ間でアーティファクトを共有する方法は次のとおりです。
- 「ジョブの設定」の説明に沿って、アーティファクトを生成するジョブの設定ページに移動します。[アーティファクト] タブをクリックします (「ジョブのビルド アーティファクトを設定する」をご確認ください)。
- 既存アーティファクトの [共有] をクリックするか、上記のように新しいアーティファクト定義を作成します。
アーティファクトを使用する後続ステージのジョブに移動して、[アーティファクト] タブをクリックします。
[Create dependency (依存関係を作成)] をクリックして、次の操作を行います。
[アーティファクト] リストから選択します。
[移動先ディレクトリ] を指定します。次に、[作成] をクリックします。
- [アーティファクト] リストには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
- [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。
- 最新の成功したビルドのアーティファクトが使用されます。アーティファクトを生成する計画のビルドが成功しなかったり、アーティファクトの有効期限が切れたりすると、そのアーティファクトを使用するジョブは失敗します。
ビルド プラン間での成果物の共有
異なるビルド計画間でアーティファクトを共有できますが、その共有には "アーティファクト ダウンローダー タスク" を使用する必要があります。たとえば、WAR を毎回再構築せずに、同じ WAR をある計画から別の計画へと共有することで、別の計画の特定ビルドで受け入れテストを実行するとします。
2 つのビルド計画でアーティファクトを共有する方法は次のとおりです。
- アーティファクトを関連付けるビルド計画を探します。
- [アクション] ドロップダウン メニューから [プランを構成] を選択します。
- [Stages & jobs (ステージとジョブ)] をクリックしてジョブを選択するか、まだジョブが存在しない場合は新しいジョブを作成します。
- 選択したジョブの [タスク] タブをクリックします。
[タスクを追加] ボタンをクリックします。"タスクの種類" ウィンドウが表示されます。[Artifact Downloader Task (アーティファクト ダウンローダー タスク)] を選択して、"アーティファクト ダウンローダー タスク" 設定ペインを開きます。
次のオプションを使用して、設定を完了します。フィールド 説明 Optional? タスクの説明 アーティファクト ダウンローダー タスクの簡単な説明 このタスクを無効化 このボックスをチェックすると、タスクが無効になります - ソース計画 ダウンロードする必要があるアーティファクトのソースであるビルド計画 - [Add another artifact (別のアーティファクトを追加)] をクリックして、別のアーティファクトをダウンロード リストに追加します。または、灰色の十字アイコンを使用して、構成からアーティファクトを削除します。
- [保存] をクリックして、アーティファクトのダウンロード設定を保存します。
- [アーティファクト] ドロップダウン メニューには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
- [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。
ビルド プランからデプロイメント環境への成果物の共有
ビルド計画からデプロイ環境へも、アーティファクトを共有できます。たとえば、計画の特定のビルド結果をデプロイ環境と共有するとします。そのためには、環境を作成中または作成後に "アーティファクト ダウンローダー タスク" をデプロイ環境に追加する必要があります。
ビルド計画からデプロイ環境へアーティファクトを共有する方法は次のとおりです。
- デプロイ プロジェクトを開き、関連する環境パネルを展開します。[その他の設定] セクションで、[タスク] ボタンをクリックします。"タスクの設定" 画面は次のように表示されます。
[タスクを追加] をクリックします。"タスクの種類" 選択ウィンドウが表示されます。[Artifact Downloader Task (アーティファクト ダウンローダー タスク)] を選択して、"アーティファクト ダウンローダー タスク" 設定ペインを開きます。
次のオプションを使用して、設定を完了します。フィールド 説明 Optional? タスクの説明 アーティファクト ダウンローダー タスクの簡単な説明。 このタスクを無効化 このボックスをチェックすると、タスクが無効になります。 - アーティファクト名 ドロップダウン メニューを使用して、ダウンロードするアーティファクトの名前を探します。 宛先パス アーティファクトをダウンロードする作業ディレクトリの場所。 - [Add another artifact (別のアーティファクトを追加)] をクリックして、別のアーティファクトをダウンロード リストに追加します。
- [保存] をクリックして、アーティファクトのダウンロード設定を保存します。
- [アーティファクト] ドロップダウン メニューには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
- [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。