...
- Download the IncrediBuild Jenkins plugin from https://incredibuild.com/downloads/incredibuild-jenkins.zipby clicking here.
- Copy the hpi file to: /JENKINS_HOME/plugins
- Restart the Jenkins service
For further information on installing plugins in Jenkins please refer to the Jenkins manual, “How to install plugins” section.
Plugin Configuration
...
- Navigate to the Jenkins job you want to configure to execute an IncrediBuild command.
- Click Configure in the upper-left area.
- In the build steps section of the page click Add build step in the dropdown menu and select one of the available IncrediBuild build steps.
- Once a build step is added, you will be able to configure the step’s parameters just below the step's title (see screenshots in the following sections). For each parameter, clicking the help icon will open a tooltip with relevant information for the selected parameter.
- See the following sections on how to configure each of the IncrediBuild build steps.
- Click Save on the configuration page.
BuildConsole (Visual Studio)
...
For more information on using IncrediBuild to accelerate Visual Studio compilationsvarious development executions such as: tests, code analysis, asset creation, or other custom executions, see IncrediBuild for DevTools in the IncrediBuild online manual.
...
Field name | Description | ||
Target Solution File | The solution file to be built. | ||
Build Type | The type of build to perform. | ||
Configuration | Determines the solution configuration to be built . (e.g. Debug|Win32). Several comma-separated configuration names can be specified : (e.g. Debug|Win32,Release|Win32). | ||
Custom Configuration Preset | Determines the projects/configurations that will be built using a Preset previously saved in the Batch Build dialog. This option is useful when a complex combination of projects and configurations is required. The /Preset command option replaces both the /cfg and the /prj options. | ||
Project | Determines a specific project to be built. By default, the dependencies of the project will be built as well. | ||
Do Not Build Dependencies for the Project | Builds only the specified project configurations, ignoring any dependencies these configurations may have. When used in conjunction with Clean, this cleans only the specified configurations. When used in conjunction with /Rebuild, this rebuilds only the specified configurations. | ||
Build all Projects Regardless of Errors | Makes a solution build continue regardless of specific projects failing to build. Normally, IncrediBuild stops the build when a project fails to build its output file. This option instructs IncrediBuild to continue building the remaining project configurations, regardless of previous projects failing to build. | ||
UseEnv | Use PATH, INCLUDE, LIBPATH, and LIB environment variables instead of MS Visual C++ IDE paths. | ||
Add Parameters to cl.exe | Allows additional compiler options to be added to all calls to cl.exe. Enter one or more commands separated by a space character, as they would appear in the cl.exe command line. e.g. /O2 /FA. | ||
Remove Parameters from cl.exe | Specifies compiler options that will be removed from all calls to cl.exe. Enter one or more commands separated by a space character, as they would appear in the cl.exe command line. e.g. /Z7 /Zd /Zi /ZI. | ||
Force Visual Studio Version | Forces a specific version of Visual Studio toolset to be used. This is especially helpful when working with upgraded projects, since Visual Studio sometimes uses the incorrect version to build a solution after it was upgraded. | ||
Use MSBuild Instead of Devenv | Sets Msbuild as the top build manager instead of devenv. Use this only if you are experiencing issues with the default Devenv builds, or if you need to pass arguments to msbuild manually using the MsbuildArgs option. | ||
Arguments for Msbuild | Passes additional arguments to MSBuild when using the BuildConsole command's UseMsbuild switch. | ||
Profile.xml | The Profile XML file is used to define how Automatic Interception Interface should handle the various processes involved in a distributed job. It is not necessary for Visual Studio or Make and Build tools builds, but can be used to provide configuration options if those builds use additional processes that are not included in those packages. You are required to configure distributable processes in Dev Tools builds. | ||
Avoid Task Execution on Local Machine When Possible | Overrides the Agent Settings dialog Avoid task execution on local machine when possible option. This allows you to free more resources on the initiator machine and could be beneficial to distribution in scenarios where the initiating machine is bottlenecking the build with High CPU usage. | ||
Maximum CPUs to Utilize in the Build | Specifies the maximum amount of remote cores to utilize in the build. Overrides global max. CPUs/Cores in build setting. | ||
Newest Allowed Helper Machine OS | Specifies the newest operating system installed on a helper machine to be allowed to participate as a helper in the build. | ||
Oldest Allowed Helper Machine OS | Specifies the oldest operating system installed on a helper machine to be allowed to participate as a helper in the build. | ||
Build Title | Specifies a custom header line which will be displayed in the beginning of the build output text. This title will also be used for the Build History and Build Monitor displays. | ||
Save IncrediBuild Monitor File | Writes a copy of the build progress (.ib_mon) file to the specified location. If only a folder name is given, IncrediBuild generates a GUID for the file name. A message containing the location of the saved .ib_mon file is added to the end of the build output. | ||
Suppress STDOUT | Does not write anything to the standard output. | ||
Output Log File | Writes build output to a file. | ||
Show Commands in Output | Shows, for each file built, the command-line used by IncrediBuild to build the file. | ||
Show Agents in Output | Shows the Agent used to build each file. | ||
Show Time in Output | Shows the Start and Finish time for each file built. | ||
Hide IncrediBuild Header in Output | Suppresses the IncrediBuild header in the build output. | ||
Internal IncrediBuild Logging Level | Overrides the internal IncrediBuild logging level for this build. Does not affect output or any user accessible logging. Used mainly to troubleshoot issues with the help of IncrediBuild support. | ||
Set an Environment Variable | Sets or overrides environment variables for the context of the build. | ||
Stop On Errors | When specified, the execution will stop as soon as an error is encountered. This is the default behavior in Visual Studio builds, but not the default for Make and Build tools or Dev Tools builds. | ||
Additional Arguments | Add additional BuildConsole arguments manually. The value of this field will be concatenated to the final BuildConsole command line. | Internal IncrediBuild Logging Level | Overrides the internal IncrediBuild logging level for this build. Does not affect output or any user accessible logging. Used mainly to troubleshoot issues with the help of IncrediBuild support. |
Nice Value | Specify nice value. |
...