Running Builds Remotely

Using remote run feature you can perform your personal build bypassing the version control system to test how your changes integrate into the project's code. Unlike pre-tested commit, no code is checked into the version control system regardless of the state of the initiated personal build.

You can observe the build status in the My Changes tab of the TeamCity tool window similar to the following screen:

To perform a remote run

In the TeamCity menu, click Remote Run.
Alternately:
- Right-click the desired changelist in the Changes and select Remote Run from the context menu.
- Click Remote Run in the Version Control menu.
In the Remote Run dialog box that opens, do the following:
1. Select changes to be included in the build from the list.
  In the Git-based projects, the list of changed files includes both the committed files and the files you locally changed. To test only changes caused by the committed files, use the Remote Run Outgoing Changes functionality.
2. Optionally, add a comment.
3. If needed, specify additional settings under Before Commit and After Commit. For more information about these settings, refer to IntelliJ Idea Web Help
4. Click Remote Run.
In the second Remote Run dialog box, do the following:
1. From the list of available build configurations, select build(s) you want to verify your changes on.
2. To customize your personal build click . Refer to Customize selected build for details.
3. Ensure that the Commit after build(s) finish (pre-tested commit) check box is cleared.
4. Click Submit to start running your personal build with selected changes.

To customize a build

In the Remote Run dialog select the build configuration that you want to run as personal build.
On the toolbar, click to open the Customize build dialog box, where you can do the following:
- Select a build agent to run your personal build on. By default, your build will be run on the fastest idle agent, however you can specify some particular agent instead.
- Modify configuration parameters, system properties and environment variables. Learn more.
- Put your build to the queue top.

Last modified: 04 April 2024