The KGS ReadCache is based on the OSGi-Framework. Since version 2.0.0 the KGS ReadCache is also available as a container in addition to the WAR-Deployment.
It is expected to have all mandatory requirements fulfilled. See: https://kgs-software.atlassian.net/wiki/spaces/~5c8bb2ef33a4404c1086f9b4/pages/2683469825/OSGi+Produkte+in+Container#Dependencies%3A
Snippet Summary
docker login https://images.docker.kgs-cloud.de/harbor/
docker pull images.docker.kgs-cloud.de/tia-readcache/tia-readcache
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
Step 1: Pull the Image
docker pull images.docker.kgs-cloud.de/tia-readcache/tia-readcache
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.
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
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). Hint: You can start multiple instances of the same containers with different ports and different names. Example: --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: -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: -v C:\KGS\cloud\mount:/application/work |
-d {IMAGE NAME} | The Image to run Requires Step 1 (pull) to be completed first Example: -d http://images.docker.kgs-cloud.de/tia-readcache/tia-readcache |