Build Status

Current development version is 0.9.0-SNAPSHOT. Build Status

Developer Workspace




For development purposes, frontend GUI and backend APIs have been separated and runs onto 2 different runtime servers.

We also need a Keycloak server running on port 8180.


Start servers

Let's begin with starting the Keycloak server. Within the installation directory of Keycloak 3.4.0, just run this command:

$ cd bin
$ ./standalone.sh -Djboss.socket.binding.port-offset=100

In a terminal, start frontend GUI server using NG :

$ cd src/main/webapp
$ ng serve

Server is started on port 4200. Open a new browser tab pointing to http://localhost:4200 where application is hosted.

$ mvn spring-boot:run

Server is started on port 8080 and will be used as API endpoints root by frontend GUI (URLs starting by http://localhost:9000/api will be indeed proxied to port 8080).

Build binaries

Build and run Fat jar

For now, there's still a problem with Frontend integration tests configuration so you should disable them using the following flag:

$ mvn -Pprod package
$ java -jar target/microcks-0.9.0-SNAPSHOT.jar

Build and run Docker image

$ mvn -Pprod clean package docker:build
$ docker-compose -f microcks-mongodb.yml up -d