Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The KGS tia® ReadCache is based on the OSGi-Framework. Since version 2.0.0 the KGS tia® ReadCache is also available as a container in addition to the WAR-Deployment.

...

Table of Contents

Snippet Summary

Code Block
docker login https://images.docker.kgs-cloud.de/harbor/
docker pull images.docker.kgs-cloud.de/tia-readcache/tia-readcache:<version>
docker run --name readcache -p 8080:8080 -v {YOUR HOST DIRECTORY MOUNT PATH}:/application/work -d images.docker.kgs-cloud.de/tia-readcache/tia-readcache:<version>

Step 1: Pull the Image

Code Block
docker pull images.docker.kgs-cloud.de/tia-readcache/tia-readcache:<version>

Step 2: Start with mount options

It is necessary to mount a filesystem path into the container in order to persist the product (KGS ReadCache) configuration. This procedure ensures that the configuration is not lost after a restart/redeploy of the container.

Code Block
docker run --name readcache -p 8080:8080 -v {YOUR HOST DIRECTORY MOUNT PATH}:/application/work -d images.docker.kgs-cloud.de/tia-readcache/tia-readcache:<version>

Explanation:

Command

Task

docker run

Start the container

--name {APPLICATION NAME}

gives the container a freely selectable name while running (to have a simpler reference for later).

Info

Hint: You can start multiple instances of the same containers with different ports and different names.

Example:

Code Block
--name MyReadCache

-p {PORT}:{PORT}

Maps the host port to the port in the container.

Our Software runs on 8080 inside the container, therefore you always want to map your arbitrary host port to 8080

Sample:

Code Block
-p 8080:8080

-v {HOST_MOUNTDIR}:{CONTAINER_MOUNTDIR}

In order to put the configuration outside of the container, its necessary to mount the /application/work directory of the container into an arbitrary host directory

Example:

Code Block
-v C:\KGS\cloud\mount:/application/work

-d {IMAGE NAME}

The Image to run

Info

Requires Step 1 (pull) to be completed first

Example:

Code Block
-d http://images.docker.kgs-cloud.de/tia-readcache/tia-readcache:<version>