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.
