The KGS Webservice is based on the OSGi-Framework. Since version 2.2.2 the KGS Webservice is available as a container.
Snippet Summary
docker login https://images.kgs-cloud.de/
docker pull images.kgs-cloud.de/tia-webservice/tia-webservice:<version>
docker run --name webservice -p 8080:8080 -v {YOUR HOST DIRECTORY MOUNT PATH}:/application/work -d images.docker.kgs-cloud.de/tia-webservice/tia-webservice:<version>
Step 1: Pull the Image
docker pull images.kgs-cloud.de/tia-webservice/tia-webservice:<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 Webservice) configuration. This procedure ensures that the configuration is not lost after a restart/redeploy of the container.
docker run --name webservice -p 8080:8080 -v {YOUR HOST DIRECTORY MOUNT PATH}:/application/work -d images.kgs-cloud.de/tia-webservice/tia-webservice:<version>
Explanation:
Command | Task |
|---|---|
docker run | Start the container |
--name {APPLICATION NAME} | gives the container a free choosable name while running (for easier access later). Hint: You can start multiple instances of the same containers with different ports and different names. Example: --name MyWebservice |
-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 arbitrarily 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 a arbitrarily host directory Example: -v C:\KGS\cloud\mount:/application/work:/application/work |
-d {IMAGE NAME} | The Image to run Step 1 needed to be complete Example: -d http://images.kgs-cloud.de/tia-webservice/tia-webservice:<version> |