teamcity-docker-compose

Compose to create working TeamCity server with PostgreSQL and Agents

This configuration use only official images:

teamcity server, teamcity agent, postgres

How to use

Clone this repository or download the zip.

git clone https://github.com/Egregors/teamcity-docker-compose.git

Configuration

First of all, you should set your Postgres username and password variables in env.example and rename env.example to .env

Don't push .env file in public repositories!

It's all. PostgreSQL already configured according to the JetBrains recommendations

HTTPs support

To add HTTPs nginx-proxy with Let's Encrypt certificates (see https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) just set your domain name and email for nginx service in compose file:

  nginx:
    image: nginx
    links:
      - teamcity-server
    volumes:
      - "./server/etc/nginx/conf.d/:/etc/nginx/conf.d/"
    environment:
      # set your domain name and email!
      VIRTUAL_HOST: ci.example.com
      LETSENCRYPT_HOST: ci.example.com
      LETSENCRYPT_EMAIL: username@example.ru

If you don't need HTTPs support – remove nginx, nginx-proxy and letsencrypt-nginx-proxy-companion services from your docker-compose file

Building and setup

Next, build the images:

cd teamcity-docker-compose
docker-compose build

Now you can Up the service and continue settings in Web Interface:

docker-compose up

After initialisation Web Interface will be available on https://yourdockerhost/ (with HTTPs support) or http://yourdockerhost:8111/

Setup DB

Open https://yourdockerhost/ or http://yourdockerhost:8111/

Set PostgreSQL as database type and click «Refresh JDBC drivers»

Configurate DB connection:

Authorize your Agent:

Done, TeamCity basically ready to work.

Scaling

Scaling you workers (agents) supported as well. Just use docker-compose scale command:

docker-compose scale teamcity-agent=3

Keep in mind, currently, agents are stateless

Backups / restore

You may use JetBrains way to backup or restore your server

Update

If you see a notice that new version an available, you may update your TeamCity that way:

# build new version
docker-compose build --pull --no-cache

# stop and remove old containers
docker-compose stop
docker-compose rm

# create and up new containers
docker-compose up -d

After update, you need to reauthorize your agents.

Updating maintenance

Sometimes, during updating you may get «maintenance is required» message instead login page. It's ok! To login in maintenance mode you need to enter an authentication token. You may find it in logs: docker-compose logs -f

Try to find something like this:

teamcity-server_1                    | [TeamCity] Administrator can login from web UI using authentication token: 8755994969038184734

Platform-specific agents

You can use our preconfigured custom agents with already installed necessary dependencies

Python3 / Django / Node.js

Agent info

Run server + agent:

docker-compose -f tc-django-nodejs-agent.yml build
docker-compose -f tc-django-nodejs-agent.yml up
# optional
docker-compose -f tc-django-nodejs-agent.yml scale teamcity-django-agent=3

Contributing

Bug reports, bug fixes, and new features are always welcome. Please open issues, and submit pull requests for any new code.