Agent Cloud Profile

Configuring a cloud provider profile is one of the steps required to enable agent cloud integration between TeamCity and a cloud provider.

A cloud profile is a collection of settings for TeamCity to start virtual machines with installed TeamCity agents on-demand while distributing a build queue. Profiles are configured on the TeamCity | Administration | Agent Cloud page. The TeamCity server URL must be accessible to the build agent.

The settings of profiles slightly vary depending on the integrated cloud type. Using the options below, you can configure whether TeamCity stops a cloud agent machine after an idle timeout elapses or immediately after the build is finished:

• Terminate instance idle time: Specify the period (in minutes) for TeamCity to wait before stopping an idle build agent. More than one build may run on the same virtual machine.

• Terminate Instance: After first build finished: Select this option if you want TeamCity to stop the virtual machine immediately after the first build finishes. TeamCity will disable the build agents and no more builds will be run on the same machine.

After an Agent Cloud profile is created with one or several sources for virtual machines, TeamCity does a test start for all the virtual machines specified in the profile to learn about the agents configured on them. Once agents are connected, TeamCity calculates their build configurations-to-agents compatibility and stores this information.

The agents information is displayed on the Agents | Cloud page under the <Profile name> drop-down.