成果物の共有

このページでは、レポート、Web サイト、.jar ファイルなど、ジョブによって生成されたアーティファクトを保存および共有する方法について説明します。Bamboo では、次の間でアーティファクトを共有できます。

ジョブに保持するアーティファクトを定義する

ジョブのアーティファクト定義を設定することで、保存するアーティファクトを指定できます。アーティファクトは、ジョブの各ビルド後に利用可能になります。

新しいアーティファクト定義を設定する方法は次のとおりです。

  1. ジョブの設定」の説明に沿って、ジョブに移動します。
  2. [アーティファクト] タブをクリックして、次に [定義を作成] をクリックします。
    1. アーティファクトの [名前] を指定します。
    2. [ロケーション] を使用し、アーティファクトを保持する場所として、ビルド ディレクトリに相対的なフォルダーを指定します。アーティファクトに絶対パスを使用しないでください。ワイルド カードはサポートされていません。
    3. [Copy pattern (コピー パターン)] は [場所] と相対関係があります。たとえば、.jar ファイルの最新バージョンを保持する場合、[Copy pattern (コピー パターン)]  を「*/.jar」に、[場所] を「ターゲット」に指定できます。 
    4. アーティファクトを計画内の他のジョブと共有する場合は、[共有] チェックボックスを選択します。
  3. 保存をクリックします。

アーティファクトは、"ビルド ディレクトリ" フォルダーの下のサブディレクトリ (/JOB_KEY/download-data/) にコピーされます。「重要なディレクトリとファイルの検索」をご覧ください。

 

ジョブ間での成果物の共有

アーティファクトの依存関係を使用して、さまざまなステージのジョブ間でアーティファクトを共有できます。たとえば、ビルドで受け入れテストを実行して、WAR を毎回再構築せずに同じ WAR をジョブ間で共有するとします。

アーティファクトが後続のジョブと共有されるたびに、ジョブのエージェントにコピーされます。

異なるステージにある 2 つのジョブ間でアーティファクトを共有する方法は次のとおりです。

  1. ジョブの設定」の説明に沿って、アーティファクトを生成するジョブの設定ページに移動します。[アーティファクト] タブをクリックします (「ジョブのビルド アーティファクトを設定する」をご確認ください)。
  2. 既存アーティファクトの [共有] をクリックするか、上記のように新しいアーティファクト定義を作成します。
  3. アーティファクトを使用する後続ステージのジョブに移動して、[アーティファクト] タブをクリックします。 

  4. [Create dependency (依存関係を作成)] をクリックして、次の操作を行います。

    • [アーティファクト] リストから選択します。

    • [移動先ディレクトリ] を指定します。次に、[作成] をクリックします。

       

 

 

  1. [アーティファクト] リストには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
  2. [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。
  3. 最新の成功したビルドのアーティファクトが使用されます。アーティファクトを生成する計画のビルドが成功しなかったり、アーティファクトの有効期限が切れたりすると、そのアーティファクトを使用するジョブは失敗します。

ビルド プラン間での成果物の共有

異なるビルド計画間でアーティファクトを共有できますが、その共有には "アーティファクト ダウンローダー タスク" を使用する必要があります。たとえば、WAR を毎回再構築せずに、同じ WAR をある計画から別の計画へと共有することで、別の計画の特定ビルドで受け入れテストを実行するとします。

2 つのビルド計画でアーティファクトを共有する方法は次のとおりです。

  1. アーティファクトを関連付けるビルド計画を探します。 
    1. [アクション] ドロップダウン メニューから [プランを構成] を選択します。
    2. [Stages & jobs (ステージとジョブ)] をクリックしてジョブを選択するか、まだジョブが存在しない場合は新しいジョブを作成します。
    3. 選択したジョブの [タスク] タブをクリックします。
  2. [タスクを追加] ボタンをクリックします。"タスクの種類" ウィンドウが表示されます。[Artifact Downloader Task (アーティファクト ダウンローダー タスク)] を選択して、"アーティファクト ダウンローダー タスク" 設定ペインを開きます。

     
    次のオプションを使用して、設定を完了します。

    フィールド説明 Optional?
    タスクの説明アーティファクト ダウンローダー タスクの簡単な説明(tick)
    このタスクを無効化このボックスをチェックすると、タスクが無効になります-
    ソース計画ダウンロードする必要があるアーティファクトのソースであるビルド計画(error)
  3. [Add another artifact (別のアーティファクトを追加)] をクリックして、別のアーティファクトをダウンロード リストに追加します。または、灰色の十字アイコンを使用して、構成からアーティファクトを削除します。
  4. [保存] をクリックして、アーティファクトのダウンロード設定を保存します。
  1. [アーティファクト] ドロップダウン メニューには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
  2. [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。

ビルド プランからデプロイメント環境への成果物の共有

ビルド計画からデプロイ環境へも、アーティファクトを共有できます。たとえば、計画の特定のビルド結果をデプロイ環境と共有するとします。そのためには、環境を作成中または作成後に "アーティファクト ダウンローダー タスク" をデプロイ環境に追加する必要があります。 

ビルド計画からデプロイ環境へアーティファクトを共有する方法は次のとおりです。

  1. デプロイ プロジェクトを開き、関連する環境パネルを展開します。[その他の設定] セクションで、[タスク] ボタンをクリックします。"タスクの設定" 画面は次のように表示されます。


  2. [タスクを追加] をクリックします。"タスクの種類" 選択ウィンドウが表示されます。[Artifact Downloader Task (アーティファクト ダウンローダー タスク)] を選択して、"アーティファクト ダウンローダー タスク" 設定ペインを開きます。


     
    次のオプションを使用して、設定を完了します。

    フィールド説明 Optional?
    タスクの説明アーティファクト ダウンローダー タスクの簡単な説明。(tick)
    このタスクを無効化このボックスをチェックすると、タスクが無効になります。-
    アーティファクト名ドロップダウン メニューを使用して、ダウンロードするアーティファクトの名前を探します。(error)
    宛先パスアーティファクトをダウンロードする作業ディレクトリの場所。(tick)
  3. [Add another artifact (別のアーティファクトを追加)] をクリックして、別のアーティファクトをダウンロード リストに追加します。 
  4. [保存] をクリックして、アーティファクトのダウンロード設定を保存します。

 

  1. [アーティファクト] ドロップダウン メニューには、共有としてマークされた前のステージにあるジョブのアーティファクトのみが表示されます。詳細は「ジョブのビルド アーティファクトを設定する」をご覧ください。
  2. [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。
最終更新日 2017 年 8 月 30 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.