Added readme file
This commit is contained in:
		
							
								
								
									
										46
									
								
								readme.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										46
									
								
								readme.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,46 @@ | |||||||
|  | # XML Tools | ||||||
|  | Content of this project is a service hosting tools for xml documents including xslt transformer, | ||||||
|  | xpath selector and xsd validator. | ||||||
|  |  | ||||||
|  | ## About project | ||||||
|  | Service is split into three microservices. | ||||||
|  | 1. JavaSpark web application serving REST API for XSD, XML, XSLT tools  | ||||||
|  | 2. Spring application serving REST mock service | ||||||
|  | 3. Nginx hosting static documents.  | ||||||
|  |  | ||||||
|  | ## JavaSpark backend | ||||||
|  | Backend is hosted by default on port 8081. Rest api documentation is contained in OpenApi document | ||||||
|  | openapi.yml | ||||||
|  |  | ||||||
|  | Rest API accepts xml documents, given querry and processor version to call requested xml engine to perform given | ||||||
|  | operation and finally returns outcome in response body. | ||||||
|  |  | ||||||
|  | ## Mocked services | ||||||
|  | MockedServices is a tool that allows developer to create, in easy and simple way, http server mocked endpoints for integration tests | ||||||
|  |  | ||||||
|  | ## Frontend | ||||||
|  | All the static files are available by default on port 8086 and are located within folder. | ||||||
|  |  | ||||||
|  | To preview given document user is required to post GET request to following path: | ||||||
|  | ```aidl | ||||||
|  | /Frontend/{document name} | ||||||
|  | ``` | ||||||
|  | Documents are hosted by docker container running on ngix image and to modify container content | ||||||
|  | one must modify Dockerfile located in Frontend folder. Files published must be located in ngix directory | ||||||
|  | within created container. | ||||||
|  |  | ||||||
|  | ## How to run | ||||||
|  |  | ||||||
|  | ### Localy | ||||||
|  | In order to run application use | ||||||
|  | ```aidl | ||||||
|  | docker-compose up --build -d | ||||||
|  | ``` | ||||||
|  | Which will launch service on localhost. | ||||||
|  |  | ||||||
|  | ### Remote | ||||||
|  | To launch service on remote host, exchange ssh keys with destination server and declare docker context ex. DEV. | ||||||
|  | Then use following command | ||||||
|  | ```aidl | ||||||
|  | docker-compose up --context DEV --build -d  | ||||||
|  | ``` | ||||||
		Reference in New Issue
	
	Block a user