| commit | f7703ff9f708c8c26e506ed59ac331fe94cc65ea | [log] [tgz] |
|---|---|---|
| author | Léo Banno-Cloutier <leo.banno-cloutier@savoirfairelinux.com> | Wed Jul 12 11:09:49 2023 -0400 |
| committer | Sébastien Blin <sebastien.blin@savoirfairelinux.com> | Tue Jul 18 15:14:13 2023 -0400 |
| tree | 2c9b477bc87b16b16b186e028c8fb7dc59422e58 | |
| parent | 50c2f5dad1f8574a2c67e8d991bff097ac456e57 [diff] |
jams-react-client: fix react-error-overlay Change-Id: I56736e0c0d643b1bcd56f93a8bd2af2143d8fe88
Clone the contents of this repository and run
mvn clean package
This will create a distribution folder called jams in the root folder. You can then launch the server by running
cd jams java -jar jams-launcher.jar
If you want to start the server with an SSL certificate and on a port different from 8080, then run:
java -jar jams-launcher.jar 8443 server.pem server.key
Where the pem and key files are a pem encoded certificate and key.
In order to generate a pair of pem and key use the following command using openssl
openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout server.key -out server.pem
To generate the documentation you will need apidoc installed on your system. This can be completed by running npm install -g apidoc, if for some reason that does not work, you can clone their project from : https://github.com/apidoc/apidoc and install it from source.
To build the documentation, enter the jams-server directory and simply run:
apidoc -i src/ -o doc/
You can then open doc/index.html. Click on 1.0.0 in the top right corner if the doc doesn't appear.
The extras folder contains a pre-commit hook that formats every js file in jams-react-client. To enable it, run:
cp extras/scripts/pre-commit .git/hooks chmod +x .git/hooks/pre-commit
A development environment with react hot reloading can be created using:
docker build -f Dockerfile -t jams:dev --target dev .
docker run -it -p 3000:3000 -p 8080:8080 \
-v $(pwd)/jams-react-client/src:/app/jams-react-client/src \
-v $(pwd)/jams-react-client/public:/app/jams-react-client/public \
--rm jams:dev
Note: It is possible that after 15 minutes, the user's token expires, the server will answer with a "You are not authentified" and forget to put the CORS headers, thus the browser will refuse to read the response. In this case, you will need to restart the server.
The following commands will generate the userguide and the jars needed:
docker build -f Dockerfile -t jams:latest --target prod . \
&& CONTAINER=$(docker create jams:latest) \
&& docker cp $CONTAINER:/app/jams/. jams \
&& docker cp $CONTAINER:/app/versions.json . \
&& docker rm -v $CONTAINER \
&& cd jams \
&& java -jar jams-launcher.jar
The files in the filters folder are prefixed "A", "B", "C" and "D" so that the order of execution of the filters are right (jakarta registers filters in alphabetical order).