This documentation relates to QuickBuild 5.0.x
Select here if you are using a different version

Store Build Artifacts on Agent

Version 1 by Robin Shen
on Dec 17, 2012 08:00.

 
compared with
Version 2 by Robin Shen
on Dec 18, 2012 13:25.

Changes from 2 to 3 >>
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 2 changes. View first change.

 Since QuickBuild 5.0, build artifacts can be stored on one or more agents to reduce load of publishing and serving artifacts from QuickBuild server. For instance, one can edit advanced setting of a configuration to store artifacts of all its builds on desired agent as below:
 !!artifact storage setting on agent!!
  !artifact-storage-setting.png!
 Thanks to the inheritance nature of configuration settings, all descendant configurations will also store artifacts on that agent unless they has its own artifact storage strategy defined.
 When you decide to store artifacts on agent, please note that:
 # You may need to tune your firewall setting to allow users accessing port of involved build agents to download build artifacts from GUI.
 # You may need to tune the firewall setting to allow other agents accessing port of involved build agents to publish and download artifacts during a build.
 # Users will be prompted to input their credentials again when downloading artifacts from GUI if artifacts are not allowed to be accessed anonymously on relevant build agents.
 # By default artifacts are stored on agent under the directory _<build agent install dir>/storage/<build id>/artifacts_. So please be careful not to remove this folder when manually upgrade your build agent (manually upgrade build agent is generally not necessary as QuickBuild server can upgrade them automatically in most cases). If you'd like to store artifacts on some other places on agent, please tune the storage setting in advanced setting of relevant configuration. For instance, you may define storage setting in root configuration as below:
 !!storage setting!!
 Then all artifacts of all configurations in the system will be stored this way (assume you have not overwrite the storage setting in descendent configurations):
 # If artifacts are stored on server, they will be stored to:
 _<global storage directory defined in system setting>/builds/<build id>_
 # If artifacts are stored on agent, they will be stored to:
 #* _<directory denoted by user attribute artifactStorage>/builds/<build id>_ if user attribute _artifactStorage_ is defined for the agent in grid page.
 #* _/mnt/storage_ if user attribute _aritfactStorage_ is NOT defined for the agent.
  # By default artifacts are stored on agent under the directory _<build agent install dir>/storage/<build id>/artifacts_. So please be careful not to remove this folder when manually upgrade your build agent (manually upgrade build agent is generally not necessary as QuickBuild server can upgrade them automatically in most cases).
 # If you'd like to store artifacts on some other places on agent, please do the following:
 ## Modify storage directory setting in advanced setting of relevant configuration like below:
 !storage-directroy-setting.png!
 ## Then define the user attribute _storageDir_ on relevant agents like below for instance:
 !user_attribute.png!