I’ve been having fun playing with the amazon EC2 cloud service. I set up a server running TeamCity, and an image of a server that just runs a TeamCity agent. I also setup TeamCity
to automatically instantiate agents on EC2 and shut them down based upon availability of free agents. Here’s how I did it: The first step was setting up the teamcity server. Create an account on amazon EC2 (BTW, amazon’s sites works better in IE than it does in chrome.. who knew!?) Open the EC2 dashboard, and click “Launch Instance” . From the “Quick Start” tab I selected from the list: “Getting Started on Microsoft Windows Server 2008 (AMI Id: ami-c5e40dac)” . it’s good enough
to just run teamcity. In the instance details, I used the default (Small instance, 1.7 GB mem). You might want
to choose a close availability zone based on where you are. We want
to “Launch instances” so click continue. Select the default kernel, RAM disk and all. No need
to enable monitoring for now (you can do that later). click continue. If you don’t have a key pair, you will be prompted
to create one. Once you do, select it in the list. Now you’ll be prompted
to create a security group. I named mine “TC” as in “TeamCity”. each group is a bunch of settings on which ports can be let through into and out of a hosted machine. keep it as the default settings. We will change them later. Click continue, review and then click “Launch”. Now you’ll be able
to see the new instance in the running instances list on your site. Now, you need
to install stuff on that instance (TeamCity!) .
To do that, you’ll need
to Remote desktop into that instance.
To do that, we’ll get the admin password for that instance: Check it on the list, and click “Instance Actions” - “Get Windows Admin Password”. You might have
to wait about 10 minutes or so for the password
to be generated for you. Once you have the password, you will
remote desktop (start-run-‘mstsc’) into the instance. It’s address is a dns address shown below the list under “Public DNS”. it looks something like: ec2-256-226-194-91.compute-1.amazonaws.com Once you’re inside the instance – you’ll need
to open IE (it is in hardened mode so you’ll have
to relax its security settings
to download stuff). I first downloaded chrome and using chrome I downloaded TeamCity. Note that the download speed is FAST. several MBs per second.
To be able
to see TeamCity from the outside, you will need
to open the advanced firewall settings inside the
remote machine, and add incoming and outgoing rules for port 80 (HTTP). Once you do that, you should be able
to see the machine from the outside. If you still can’t, see the next step. I also enabled ports 9090 since I will use this machine
to create an agent image later as well. Now configure the security group (TC)
to enable talking
to agents: IN the EC2 dashboard click on “Security Groups” and select your group.
To add a rule, click on the empty list under the ‘protocol’ header. select TCP. from and ‘to’ ports are 9090. source ip is 0.0.0.0/0 (every ip is allowed). click “Save. Also make sure you can see “HTTP” tcp 80 in that list. if you can’t see it, add it or you won’t be able
to browse
to the machine’s teamcity server home page. I also set an elastic IP for the machine: so I always have the same IP for the machine instance. Allocate and set one through the”Elastic IP”
link on the EC2 dashboard. you should now have a working instance of teamcity. Now let’s create an agent image. Repeat steps 1-9, but this time, make sure you select a machine that fits what an agent might do. I selected Instance type – Hihg-CPU medium machine, that is much faster. On that machine, I installed what I needed (VS 2010, PostSharp etc..). downloading VS 2010 from MSDN (2 GB took less than 10 min!) Now, instead of installing teamcity, browse using the browser
to the teamcity homepage (from within the
remote machine). go
to the Administration page, and click the upper right
link “Install agents”. Install the agent on he local machine – set it
to the IP or DNS of the running TeamCity server. That way you’ll be able
to check their connectivity live before making this machine your official agent image
to reuse. Once the agent is installed, see that the TC server can see it and use it. see steps 13-14 above if they can’t. Once it works, you can take steps
to make this image your agent image
to be reused. next, here is a copy-paste of several steps
to take from http://confluence.jetbrains.net/display/TCD5/Setting+Up+TeamCity+for+Amazon+EC2 Configure system so that agent it is started on machine boot (and make sure TeamCity server is accessible on machine boot). Test the setup by rebooting machine and checking that the agent connects normally
to the server. Prepare the Image for bundling: Remove any temporary/history information in the system. Stop the agent (under Windows stop the service but leave it in Automatic startup type) Delete content agent logs and temp directories (not necessary) Delete "<Agent Home>/conf/amazon-*" file (not necessary) Change config/buildAgent.properties
to remove properties: name, serverAddress, authToken (not necessary) Now, we need to: Make AMI from the running instance. Configure TeamCity EC2 support on TeamCity server. Making an AMI: Check the instance of the agent in the EC2 dashboard instance list, and select instance actions->Create Image (EBS AMI) you’ll see the image pending in the APIs list in the EC2 dashboard. this could take 30 minutes or more. meanwhile we can configure the could support in the teamcity server. COPY THE AMI ID
to the clipboard (looks like ami-a88aa4ce) Configuring TeamCity for Cloud: In TeamCity, click on “Agents” and then on “Cloud” tab. this is where you will control your cloud agents.
to configure new cloud agents based on APIs, click on the right
link to the “configuration page” Create a new profile and select AMazon EC2 as cloud type. Use your AMI ID that you copied
to the clipboard into the “Images” field. Select an availability zone that is the same as the one your instance is running on for best communication perf between them make sure you select the ‘TC’ security group hopefully, that should be it, and teamcity will try
to instantiate new instances on demand. Note that it may take around 10 minutes for an agent
to become available
to teamcity from the time it’s started.
