Building Teamwork Cloud containers

This page provides instructions and sample scripts on how to build Cassandra and Teamwork Cloud containers from the Teamwork Cloud No Install archive. These containers can be run on any orchestration platform together with WebApps to ensure easy Teamwork Cloud deployment.

Creating a Docker image

To create a Docker image

1. Create a working directory image/

2. Extract the content of Teamwork Cloud No Install archive for Linux to image/ to create a folder named image/TeamworkCloudSuite/

   You can modify your configurations as needed:

   • • TeamworkCloudSuite/jvm.options

     • TeamworkCloudSuite/configuration/application.conf

     • TeamworkCloudSuite/configuration/logback.xml

3. Run the following command. Do not forget to add a space and a full stop at the end.

   docker build -t twcloud .

   You can choose a different image name, if necessary.

   
   

Example with Docker Compose

1. Create a working directory compose/
2. Copy the content from image/TeamworkCloudSuite/configuration to compose/configuration
3. Modify configurations as needed:
   • configuration/application.conf
   • configuration/logback.xml
4. In this sample, it is mandatory to modify configuration/application.conf as follows:
   • Change the key value esi.persistence.datastax-java-driver.basic.contact-points from 127.0.0.1:9042 to cassandra:9042
5. (Optional) You can modify the memory limits for Cassandra and Teamwork Cloud in docker-compose.yml

6. Run the following command. Do not forget to add a space and a full stop at the end.

   docker build -t twcloud .

   You can choose a different image name, if necessary.

Helpful commands

To show the output of the Teamwork Cloud Docker container:

docker compose logs -f twcloud

To stop all Compose containers:

docker compose stop

To stop and remove all containers:

docker compose down -v

Building Teamwork Cloud containers in a clustered environment

To build Teamwork Cloud container in a cluster

1. Create a Docker image.
2. Then do the following on each host:
   1. Expose port 2552 by adding it to compose/docker-compose.yml#twcloud.ports (same as 8111 port).
   2. Configure compose/configuration/application.conf key akka.cluster.seed-nodes as as described in the article Teamwork Cloud Cluster Setup.
   3. Modify CASSANDRA_SEEDS in compose/docker-compose.yml as described in the article Teamwork Cloud Cluster Setup.

   4. Run command:

      docker compose up -d

Configuring Cassandra on a host machine

Docker provides a special hostname for the host machine: host.docker.internal

How to use the special hostname

1. Change the configuration/application.conf key esi.persistence.datastax-java-driver.basic.contact-points to host.docker.internal:9042
2. Remove or comment all sections of cassandra under services in docker-compose.yml
3. Remove or comment all sections of depends_on under twcloud