TeamCity Plugin for Eclipse provides the TeamCity Remote Run wizard that makes it possible to create your personal build that runs remotely and is just the same as a regular build. However, your personal build includes automatic integration of all the latest changes, but these changes bypass the version control system. They will be checked in to the version control only if they successfully integrate into the project code base.
If a personal build fails, the regular build is not affected, and the code changes are not checked in to the version control. This helps avoid the adverse impact on the results of team work. You receive immediate notification and can fix the errors, navigating directly to the problem locations in the source code. Also, you can use the Pre-tested Commit option (see later in this topic). This feature allows you to automatically commit changes tested in your personal build to the configuration's VCS.
This topic explains how you can start the TeamCity Remote Run wizard and configure your personal build.
To start the TeamCity Remote Run wizard
-
From the Eclipse IDE, you can start the wizard in any of the following ways:
- On the main menu, choose TeamCity > Remote Run.
- In the Project Explorer tree view, select files or containers with your local changes, and then on the context menu, choose Team > Remote Run.
- In the TeamCity Local Changes view, select files or containers with your local changes, and then on the context menu, choose TeamCity Remote Run.
- When editing a file, right-click the Editor window, and then on the context menu, choose Team > Remote Run.
To configure a personal build
-
In the first dialog box of the TeamCity Remote Run wizard, do the
following:
- Under Comment, type in an optional description of your changes or select a comment from the Recent comments list.
-
If necessary, select the Commit after build(s) finish check box and then select a
pre-tested commit condition from the provided drop-down list.
This ensures that TeamCity will automatically commit your changes to VCS if the build results meet the selected condition. - Optionally, select Ask for confirmation before commit check box.
- Under Changes, select local changes to verify in your personal build.
-
To run your personal build on already selected build configurations,
click Run
-- OR --
click Next to proceed with the wizard.
The Remote Run Configuration dialog box is opened.
- In the Remote Run Configuration dialog box:
- Select build configurations to verify your changes on.
- If needed, customize configuration settings specifically for this personal build. To do
so, click the
icon.
- Select an agent to run your personal build on.
- Adjust run options: force putting your build to the queue top, and, if needed, enforce rebuilding of all dependencies instead of reusing existing build.
- Add specific build parameters. Learn more about build parameters in TeamCity.