richardkdrew/teamcity repository overview

⁠TeamCity Server - Docker Image

A Docker image that installs TeamCity continuous integration and build management server using the binaries found at jetbrains.com⁠. It is built on top of the official debian (jessie) base image plus the java 8 run time environment.

The image sets up the TeamCity server to

• Run as the teamcity user with reduced privileges.
• It exposes /var/lib/teamcity as the data directory volume.
• It exposes 8111 as the default port number.

When running TeamCity as a docker container, it is highly recommended you separate (externalise) the data directory (see Data Directory⁠) and use a different container or externally hosted database.

⁠Installation

1. Install Docker⁠.

2. Download automated build⁠ from public Docker Hub Registry⁠:

docker pull richardkdrew/teamcity

OR

Build a local image from the Dockerfile source:

docker build -t="richardkdrew/teamcity" github.com/richardkdrew/docker-teamcity

⁠How to use this image

You can run a container from this image (in it's simplest form), where the data directory is internal to the container and you intend to use the local HSQLDB database, using the following command;

docker run -d --name teamcity -p 0.0.0.0:8111:8111 richardkdrew/teamcity

However, I would recommend externalising the data directory (exposed by this image as a volume - /var/lib/teamcity).

⁠How to use an external TeamCity data directory

Using a folder on the host mounted as the data directory volume with the following command;

docker run -d --name teamcity -p 0.0.0.0:8111:8111 -v /path-on-my-machine/teamcity-data:/var/lib/teamcity richardkdrew/teamcity

Where /path-on-my-machine/teamcity-data is the folder on the host and /var/lib/teamcity is the location in the container it is mapped to (see Docker Volumes⁠ for more info).

OR

Using a data-only container as the data directory volume with the following command;

docker run -d --name teamcity -p 0.0.0.0:8111:8111 --volumes-from teamcity-data richardkdrew/teamcity

Where teamcity-data is the name of the data-only container. This assumes you have already set up a data-only container i.e.

docker run --name teamcity-data -v /var/lib/teamcity debian:jessie /bin/false

⁠Additional Notes

To run a build using TeamCity server you will need to be running at least one Build Agent⁠.