Sharing artifacts

Screenshot: Creating an artifact dependency

Sharing artifacts between build plans

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.

To share an artifact between two build plans:

1. Locate the build plan that you wish to associate an artifact with. 
   1. Select Configure plan from the 'Actions' drop down menu. The plan configuration window will display
   2. Click on Stages & jobs and select a job or create a new job if one does not already exist 
   3. Click on the Tasks tab for the selected job. The 'Tasks' pane will appear

2. Click the Add task button. The 'Task types' window will appear. Select Artifact Downloader Task to open the 'Artifact downloader task' configuration pane:

   

    
   Complete the configuration using the following options:

   Field	Description	Optional?
   Task description	A brief description of the artifact downloader task
   Disable this task	Check this box to disable the task	-
   Source Plan	The build plan that is the source of the artifact you need to download

3. Click on 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. Click on Save to save your artifact download configuration.

Sharing artifacts from a build plan to a deployment environment

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. 

To share an artifact from a build plan to a deployment environment:

1. Open your deployment project and expand the relevant environment panel. In the Other settings section, click on the Tasks button. The 'Set up tasks' screen will display:
   
   
   

2. Click Add task. The 'Task type' selection window will display. Select Artifact Downloader Task to open the 'Artifact downloader task configuration' pane:

   
    
   Complete the configuration using the following options:

   Field	Description	Optional?
   Task description	A brief description of the artifact downloader task
   Disable this task	Check this box to disable the task	-
   Artifact Name	Use the drop down menu to locate the name of the artifact that you want to download
   Destination Path	The location of the working directory into which you want the artifact downloaded

3. Click Add another artifact to add another artifact to the download list. 
4. Click Save to save your artifact download configuration.