mindol1004/ddd-cqrs-4-java-example
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Enhanced doc

Browse Source
This commit is contained in:
Michael Schnell
2019-12-26 08:29:07 +01:00
parent 0f7ec8a6dd
commit dfbbd4a819
1 changed files with 57 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
quarkus/README.md
View File

@@ -6,7 +6,7 @@ Make sure you have the following tools installed:
* [git](https://git-scm.com/) (VCS)
* [Docker CE](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)
* [Docker Compose](https://docs.docker.com/compose/)
* [GraalVM](https://www.graalvm.org/)
* *OPTIONAL* [GraalVM](https://www.graalvm.org/)
Or simply use the [lubuntu-developer-vm](https://github.com/fuinorg/lubuntu-developer-vm) that has already everything installed.
Then execute the following steps:
@@ -24,45 +24,41 @@ Then execute the following steps:
4. OPTIONAL: Change memory of virtual machine to 8 GB (instead of 4 GB default) if you want to create a native image with GraalVM
## Getting started
1. Open a console (Ubuntu shortcut = <ctrl><alt><t>)
1. Open a console (Ubuntu shortcut = ctrl alt t)
2. Clone the git repository
```
git clone https://github.com/fuinorg/ddd-cqrs-4-java-example.git
```
3. Change into the new directory and start Event Store and PostgreSQL using Docker Compose
```
cd ddd-cqrs-4-java-example/quarkus
docker-compose up
```
(Wait until everything is started)
4. Open another console (Ubuntu shortcut = ctrl alt t)
5. Change into the quarkus directory and build the project
3. Change into the quarkus directory and build the project
```
cd ddd-cqrs-4-java-example/quarkus
./mvnw install
```
## Start Event Store and Maria DB
1. Open a console (Ubuntu shortcut = ctrl alt t)
2. Change into the quarkus directory and run Docker Compose
```
cd ddd-cqrs-4-java-example/quarkus
docker-compose up
```
## Run the command microservice in development mode
1. Open a console (Ubuntu shortcut = ctrl alt t)
2. Start the command microservice:
```
cd ddd-cqrs-4-java-example/quarkus/command
./mvnw quarkus:dev
```
## Run the query microservice in development mode
1. Open a console (Ubuntu shortcut = <ctrl><alt><t>)
1. Open a console (Ubuntu shortcut = ctrl alt t)
2. Start the query microservice:
```
cd ddd-cqrs-4-java-example/quarkus/query
./mvnw quarkus:dev
```
## Build and run the query microservice in native mode
1. Make sure you have enough memory (~6-8 GB) on your PC or VM
2. Open a console (Ubuntu shortcut = <ctrl><alt><t>)
3. Build the native executable
```
cd query
./mvnw verify -Pnative
```
4. Run the microservice
```
./target/cqrs4j-quarkus-example-query-1.0-SNAPSHOT-runner -Djava.library.path=$GRAALVM_HOME/jre/lib/amd64 -Djavax.net.ssl.trustStore=$GRAALVM_HOME/jre/lib/security/cacerts
```
## Test
1. Open [http://localhost:2113/](http://localhost:2113/) to access the event store UI (User: admin / Password: changeit)
2. Opening [http://localhost:8080/persons](http://localhost:8080/persons) should show an empty JSON array
@@ -76,3 +72,40 @@ Then execute the following steps:
```json
[{"id":"f645969a-402d-41a9-882b-d2d8000d0f43","name":"Peter Parker"}]
```
## Stop Event Store and Maria DB and clean up
1. Stop Docker Compse (Ubuntu shortcut = ctrl c)
2. Remove Docker Compose container
```
docker-compose rm
```
# TODO ... (Does currently not work)
## *OPTIONAL* Build and run the command microservice in native mode
1. Make sure you have enough memory (~6-8 GB) on your PC or VM
2. Open a console (Ubuntu shortcut = <ctrl><alt><t>)
3. Build the native executable
```
cd command
./mvnw verify -Pnative
```
4. Run the microservice
```
./target/cqrs4j-quarkus-example-command-1.0-SNAPSHOT-runner -Djava.library.path=$GRAALVM_HOME/jre/lib/amd64 -Djavax.net.ssl.trustStore=$GRAALVM_HOME/jre/lib/security/cacerts
```
## *OPTIONAL* Build and run the query microservice in native mode
1. Make sure you have enough memory (~6-8 GB) on your PC or VM
2. Open a console (Ubuntu shortcut = <ctrl><alt><t>)
3. Build the native executable
```
cd query
./mvnw verify -Pnative
```
4. Run the microservice
```
./target/cqrs4j-quarkus-example-query-1.0-SNAPSHOT-runner -Djava.library.path=$GRAALVM_HOME/jre/lib/amd64 -Djavax.net.ssl.trustStore=$GRAALVM_HOME/jre/lib/security/cacerts
```