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