Before you start activating IncrediBuild Cloud, you should verify that you have the following:
IncrediBuild Package – IncrediBuild Cloud is included in all IncrediBuild packages, including the FreeDev package, starting from version 9.4 and up.
Note
If you receive a new IncrediBuild license after you already activated IncrediBuild Cloud solution, follow these guidelines:
- If you had a Pro/Enterprise license – you do not need to deactivate IncrediBuild Cloud in order to activate the new license. You can activate the new license while IncrediBuild Cloud solution is running.
- If you had a FreeDev license – you need to deactivate IncrediBuild Cloud before activating the new license. After you activate the new license, re-activate IncrediBuild Cloud.
Installed Coordinator – the activation and management of IncrediBuild Cloud is done via the Coordinator Monitor. To verify that you have the Coordinator version that includes IncrediBuild Cloud, perform one of the following:
Note
For using IncrediBuild Cloud, you can install the Coordinator either on an on-premises machine or on a VM on the cloud. If your Initiating machines are located on the cloud, for performance reasons it is recommended to install the Coordinator on the cloud as well. However, this is not a mandatory requirement.
- New users – install IncrediBuild Coordinator, as described in https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11796481/Typical+Installation
♦ The current installation file of IncrediBuild Coordinator already includes IncrediBuild Cloud.
- Existing users – if you are not using the latest version, upgrade the Coordinator to the most up-to-date version.Note
If you are not using the latest version, a green message appears on your Coordinator Monitor:
To upgrade your Coordinator Monitor, click the message and follow the instructions. For more information on the upgrade process, see Upgrading IncrediBuild.
- Installed Initiator Agent(s) – install one or more Initiator Agents on the machines that will execute tasks. These machine can be either on-premises or on the cloud. You can install additional Initiator Agents after IncrediBuild Cloud is activated and running. To install an Initiator Agent, follow the steps described in:
https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11796481/Typical+Installation - [Best Practice] Agent Settings – Concurrent PDB file instances – it is recommended to increase the limit of the PDB files belonging to the same project that can be built concurrently, or to cancel this limit entirely. For detailed information, see the following instructions.
Network Prerequisites
- The Cloud Helper Agents that IncrediBuild Cloud creates must have an open Outbound communication to the IncrediBuild Cloud service, please ensure your Cloud account policy allow it.
- The Initiators must have access to the VNET of the Cloud agents machines.
Managing the Limit of Concurrent PDB File Instances
IncrediBuild enables you to limit the number of PDB files belonging to the same project that can be built concurrently. This results in a smaller number of PDB files and an acceleration of link times, but it also limits the potential for parallelization in builds. This means that the number of compilations that can run in parallel for a specific project cannot be more than the number that is specified as a limit. When using IncrediBuild Cloud, it is recommended to increase the specified limit or to remove this limit entirely, in order to fully utilize the cloud resources.
Info: For more information on this Agent setting option, see: https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11272227/Visual+Studio+Builds
> To increase or cancel the limit of concurrent PDB file instances:
- Open the Agent Settings dialog box.
- Select Visual Studio Builds -> Advanced.
- On the PDB File Allocation section -> Limit concurrent PDB instances to check box, perform one of the following:
- Increase the number of instances that can run concurrently,
- or -
- Clear the check box to remove any limit.
