成果物の共有

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

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

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

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

  1. Navigate to the job, as described in Configuring jobs.
  2. Select the Artifacts tab, and then Create definition:
    1. Specify a Name for the artifact.
      Names can contain only alphanumeric characters, underscores, dashes, and spaces.
    2. In Location, specify the folder relative to the build directory, where the artifact will be located. Don't use the absolute path to the artifact. Wildcards are not supported.
    3. In Copy pattern(s), specify the name (or Ant file copy pattern) of the artifact or artifacts you want to keep relative to Location. For example, if you want to keep the latest version of a .jar file, you could specify Copy pattern to be  */.jar and the Location to be target
    4. In Exclusion pattern(s), specify the name (or Ant file copy pattern) of the artifact or artifacts that you want to exclude. For example: **/*.jar.
    5. アーティファクトを計画内の他のジョブと共有する場合は、[共有] チェックボックスを選択します。
    6. Select the Required check box if you want to fail the build if the artifact cannot be published.
    7. Select the Compression check box if you want to compress the artifact when it's transferred between an agent and the server.
  3. 保存 を選択します。

Artifacts are copied to a subdirectory (/JOB_KEY/download-data/) under your Build Directory folder – see Locating important directories and files.


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

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

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

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

  1. Navigate to the configuration pages for the job that will produce the artifact, as described in Configuring jobs, and select the Artifacts tab (see Configuring a job's build artifacts).
  2. Either select Share for an existing artifact, or create a new artifact definition, as described above.
  3. Navigate to the job in a subsequent stage that will consume the artifact, and select the Artifacts tab. 

  4. Select Create dependency, then:

    • Select from the Artifact list.

    • Specify the Destination directory, then select Create.

      Create artifact dependency window 



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

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

You can share artifacts between different build plans, however you need to use the Artifact downloader task to do so. For example, you may want to run acceptance tests on a particular build from a different plan by sharing the same WAR from one plan to another without rebuilding it each time.

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

  1. アーティファクトを関連付けるビルド計画を探します。 
    1. Select ActionsConfigure plan.
    2. Select Stages & jobs and select a job or create a new job if one does not already exist.
    3. Select the Tasks tab for the selected job.
  2. Select Add task > Artifact downloader.

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

    フィールド説明 Optional?
    タスクの説明アーティファクト ダウンローダー タスクの簡単な説明。(tick)
    このタスクを無効化Select this checkbox to disable the task.-
    Add condition to taskMake task run only when a certain condition is met. 
    You can find conditions on Atlassian Marketplace or implement your own.
    (tick)
    Source planThe build plan that is the source of the artifact you need to download.(error)
  3. Select Add another artifact to add another artifact to the download list. Alternatively, use the grey cross icon to delete an artifact from your configuration.
  4. 保存 を選択します。
  1. The Artifact dropdown menu only shows artifacts from jobs in previous stages that have been marked as shared. This is described in Configuring a job's build artifacts.
  2. [移動先ディレクトリ] はビルド ディレクトリと相対関係があります。移動先ディレクトリを参照するのに絶対パスを使用しないでください。

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

You can also share artifacts from a build plan into a deployment environment. For example, you may wish to share a particular build result from a plan with a deployment environment. To do this, you need to add the Artifact downloader task to a deployment environment during or after the environment creation process. 

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

  1. Open your deployment project. Expand the relevant environment panel, and select Edit tasks. Select Add task > Artifact download.
  2. 次のオプションを使用して、設定を完了します。

    フィールド説明 Optional?
    タスクの説明アーティファクト ダウンローダー タスクの簡単な説明。(tick)
    このタスクを無効化Select this checkbox to disable the task.-
    Add condition to taskMake task run only when a certain condition is met. 
    You can find conditions on Atlassian Marketplace or implement your own.
    (tick)
    Artifact nameUse the dropdown menu to locate the name of the artifact that you want to download.(error)
    Destination pathアーティファクトをダウンロードする作業ディレクトリの場所。(tick)
  3. Select Add another artifact to add another artifact to the download list. 
  4. 保存 を選択します。


  1. The Artifact dropdown menu only shows artifacts from jobs in previous stages that have been marked as shared. This is described in Configuring a job's build artifacts.
  2. Destination directory is relative to the build directory. Don't use the absolute path to refer to the destination directory.
最終更新日 2022 年 11 月 23 日

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

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