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