Configure Ubuntu headless server 16.x as TeamCity Build Agent to use Cake

Setting up a cross platform DevOps environment for ASP.net Core applications, we will learn how to configure a headless ubuntu server to act as TeamCity BuildAgent to use Cake to build ASP.net Core applications.

Information

This guide assumes you have configured a ubuntu 16.X headless server with .net core CLI.
Check out Install .net core on ubuntu 16.x headless server

Install the prequisites

You will also need install Mono-Complete

Mono is a platform for running and developing applications based on the ecma/iso standards. mono is an open source effort led by xamarin. mono provides a complete clr (common language runtime) including compiler and runtime, which can produce and execute cil (common intermediate language) bytecode (aka assemblies), and a class library.

Install Mono on Ubuntu 16.x

Although not strictly necessary to build .net core applications we will also install Mono on the server to facilitate the building of other .net framework applications.

Install mono-complete via the terminal

Shell

Test Cake Build on the server

In order to test that we have the server configured correctly We can now try out Cake following instructions from CakeBuild.net – Getting Started example.

Install the Bootstrapper

Shell

Create a Cake script

We will use nano to create the file

Shell

Copy & Paste the sample code

C#

Information

If you want more information about how to write a cake build script.
Check out How to write a Cake Build script for ASP.net core project

Change permission on build.sh

Shell

Execute the Build

Shell

We should see the following result indicating that we were able to successfully build a project using Cake on the server.

Shell

Configure as Build Agent

We are going to be using this server as an external build agent for use with TeamCity. In my scenario I have TeamCity installed on a seperate ubuntu server.

We need to install a few more pre-requisites to enable this.

Install Unzip

Shell

Install Java JDK & JRE

TeamCity is a Java based application therefore all build agents etc have been developed using Java.

Add a reference to the Oracle PPA then update your package repository

Shell

Install Oracle JDK 8

Shell

Check your Java Version

Shell

The version information returned should be similar too

Shell

Configure JAVA_HOME environment variable
To find out where Java was installed

Shell

Copy the path from your preferred installation and then open /etc/environment using nano or another text editor. sudo nano /etc/environment

At the end of the file on a new line paste the following or whatever your java installation path is JAVA_HOME="/usr/lib/jvm/java-8-oracle"

Refresh your terminal windows source source /etc/environment

We can now test the environment variable has been set echo $JAVA_HOME

Configure using Agent Push from TeamCity

We can now configure this server as BuildAgent from within TeamCity utilizing the Agent Push functionality.

Set Agent to Auto Start

Shell

Paste the following code, change the name of the USER variable to whatever username required to run the the script. In my case I have created an agentuser account. You may need to change this value to suit your environment.

Shell

Setting up and Running Additional Build Agents

Provide the sufficient permissions for the file to execute

Shell

Add it to the start up process

Shell

Reference Sites

Gary Woodfine

Technical Director at Denizon
Gary is Technical Director at Denizon, an independent software vendor specialising in IoT, Field Service and associated managed services,enabling customers to be efficient, productive, secure and scalable in a way which helps them address and reduce their ecological impact.

Denizon's product line successfully integrate IoT, Artificial Intelligence and Blockchain technology to enable efficient, productive, secure and scalable solutions to help organisations address increasing energy demands, ecological impact and Health & Safety concerns of their staff.

Latest posts by Gary Woodfine (see all)