Teamwork Cloud 2022x Refresh1 Documentation

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

$body
These procedures are intended for users with Docker knowledge. We do not support Docker, just provide guidelines on how to use it with our product. For more information about Docker, see https://docs.docker.com/

Example package

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.

To build your Teamwork Cloud container, download the ZIP archive below:

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

This requires 12GB of RAM.

  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
  • No labels