I didn't realize that there is a free version of Teamcity until last night and the features are fairly decent. There is a 50% discount for startups and free for open source projects. This is welcoming.
Jumping right into it. I downloaded the windows version and the installation was fairly simple with the executable, but I could not get it to work. The browser would just show a blank page. I quickly switched over to my favorite way of doing things - Docker - and it worked right away.
docker run -d --name teamcity-server-instance \
-v $HOME/docker-shares/teamcity/server:/data/teamcity_server/datadir \
-v $HOME/docker-shares/teamcity/logs:/opt/teamcity/logs \
-p 8111:8111 \
Open http://localhost:8111 and you see a very welcoming 'Teamcity First Start' page.
I kept the installation simple. I chose the internal database option for the database and accepted the license agreement. I created a user account on the next form and I was brought to the settings page which shows off some pleasing features like:
- Version control integration
- Email, Jabber, IDE and Windows notifier
- Some popular plugin choices and tools on the right
Step 1: Click on 'Projects' link on the top left and click 'Create Project' - 'Manually'.
Step 2: Enter project details and click 'Create'
Features observed: Very interesting feature titles that I will explore later.
- Build Configuration Templates
Step 3: Build Configuration
Click 'Create build configuration' - 'Manually'.
I came this far to realize that I cannot do a simple 'echo "Hello Teamcity"'. I have to integrate with a version control system to proceed with this trial.
Step 4: Integrating with Github
There are two tiny icons below the 'Repository URL' textbox for github or bitbucket. I chose github because I have a few projects there that I could build easily. Click on the 'Github' icon.
We have to register our local teamcity instance with GitHub. This was easier to do on Jenkins, CircleCI and TravisCI.
Click 'register Teamcity' and create a new application token on GitHub. Just copy paste as stated in the screen above.
When you click 'Register application', a new client id and client secret are created. Copy paste from github page to the teamcity github connection page and save. This takes you to a connection page instead of taking you back to your project configuration page. Just use the browser's back button to go back to your project configuration page. Now, the github icon will be showing as enabled.
Click on the github icon and sign in with your github credentials.
Step 5: Select project to build and trigger the build
I have a marstime github project. It is a maven project with java code. It is not perfect, not accurate and it is not well written. But, it compiles and runs.
Select the github project and click create.
Step 6: Run the build
I was expecting teamcity to start building this code like Jenkins does on the master when it does not have agents. That didn't happen on teamcity. I clicked on 'Run' three times. Now there are three builds in the queue.
I'll have to create a teamcity agent docker container and hook it up to this teamcity server. Coming soon in part 2 of this blogpost.