henryboco
henryboco

Reputation: 13

How To Assign A Different Machine/Server As Build Agent In TeamCity?

I'm just wondering on how to assign a different machine/server as a build agent in TeamCity.

Any help will be greatly appreciated :)

Upvotes: 1

Views: 1343

Answers (1)

Matt
Matt

Reputation: 3704

Installing a new build agent is a fairly straight forward process.

If you access your teamcity site (http://teamcity) through a browser from the target build agent machine (the windows 2008 server in this case) then you can download the installer directly to that machine.

  1. Navigate to the administration section and click on Install Build Agents

enter image description here

  1. Click on MS Windows Installer and download the agentinstaller.exe

enter image description here

  1. Start the installer and ensure you are installing a windows service

enter image description here

  1. Enter your destination directory for the build agent - This is where the working directory and configuration will reside, and click next to perform the installation

  2. You then need to provide details of you TeamCity server so the agent can communicate back to the server. Enter the correct url of the server and choose a name for this agent and click save

enter image description here

  1. Run the agent under the SYSTEM account for now, unless you have a dedicated network account (recommended) and start the build agent service

enter image description here

  1. You will now need to enable the agent inside of the TeamCity UI (this may take a few minutes to appear). It will first appear as unauthorized and you'll have to wait for it to upgrade and reconnect.

enter image description here

Once this has happened, you can authorize the agent by clicking the Authorize agent button. A dialog will popup where you can enter some notes if required.

enter image description here

TeamCity Documentation - Installing via MS Windows Installer

There are limitations on the number of agents you can have under you license so you may need to purchase an additional one, but I suspect in this case you'll be okay - TeamCity Licensing

Hope this helps

Upvotes: 3

Related Questions