Skip to content

Latest commit

 

History

History
 
 

official-docker-images

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
https
https
 
 
.env
.env
 
 
README.md
README.md
 
 
docker-compose.yml
docker-compose.yml
 
 
nginx-license-server.dockerfile
nginx-license-server.dockerfile
 
 

README.md

How to use the official JChem Microservices Docker images

This is an example of how to use the official docker images. For this example to use you will need licenses for the JChem Microservices Modules (downloaded to this folder as license.cxl) and docker and docker-compose installed on your system.

Disclaimer

This is just a quick example. If you use this example to build your system, then be prepared to do your own security settings. Feel free to change any parts to make your life easier, this version only solves the purpose to get you started.

How to run

  1. Check the JMS version in the .env file, and change it to the one you need
  2. Execute docker-compose up

What is happening in this example?

The docker-compose file has a description of the JChem Microservices system whit a central license server. The license server is a module we build during UP command, and it is based on Nginx image.

How to access the system?

In the end the port 8080 will be open and forwarded towards the outer world.

How to update the license file?

If you already have a license server then the related docker image (cxn/jms/nginx-license-server:latest) should be deleted first. New license file should be placed in the folder and docker compose can be started - it re-builds the license server automatically.

What could be on volumes?

  • /app/jws/jws-db/data folder contains all the data you upload to JMS DB.
  • /app/jws/jws-config/common-config folder contains all the configurations for the services
  • /app/jws/logs/ folder contains all the log files

These folders in a production environment could be on volumes depending on your needs, but this is only a kick-starter example, it does not aim to teach docker basics. If you want to restructure the conatiners, feel free. If you would like to save more persistent data, than it is up to you.

How to start with HTTPS

The files in the https folder are a variant of this example where jms-gateway is configured with HTTPS access. Necessary configurations in the https/.env file should be updated before execution:

  • KEY_STORE_FILE - Key store file name. It should be placed next to the https/docker-compose.yml file
  • KEY_STORE_PASSWORD - Password of keystore
  • KEY_STORE_TYPE - Key store type (e.g. PKCS12)