Getting Started (Mac OSX)

March 18, 2019 · View on GitHub

Workstation Setup

Install Docker
Install the Haskell Platform
- GHC
- Cabal build system
- Stack tool

Build and Run GSD

Build

Git clone this project

git clone git@github.com:Eventuria/gsd.git

Go at the root of the clone :
```
stack build
```

Run

You are about to run 6 services :

1 user interface gsd-cli
Relying on 5 services:
- eventstore-service
- gsd-command-sourcer
- gsd-command-consumer
- gsd-read
- gsd-monitoring

(For more information about these services, please read the Technical Feature Set Section)

In order to understand the technical aspects of the system, I recommend you to run 1 service per terminal as in this example :

Run the eventStore on docker
```
docker run --name eventstore-service -dit -p 2113:2113 -p 1113:1113 eventstore/eventstore
```
This command docker run will :
- Download the EventStore docker image
  
  Warning : This operation could take a while since you need to download the docker image...
- Run that docker image into a docker container named eventstore-service (in background mode)
- Open the docker container on the port 1113 for gsd services
- Open the docker container on the port 2113 for the event store website (username: admin, password: changeit )
Tips for handling that docker container created :
- docker stop eventstore-service to stop the service.
- docker start eventstore-service to start the service.
- docker rm eventstore-service to delete the container.
run the Command Sourcer service
```
stack run gsd-command-sourcer
```
run the Command Consumer service
```
stack run gsd-command-consumer
```
run the read service
```
stack run gsd-read
```
run the monitoring service
```
stack run gsd-monitoring
```
run the Command Line Interface service
```
stack run gsd-cli
```

Once all the services are up and running, the gsd-cli will give access to gsd features, you should see something similar to the following :

###############################################
||          Service Health Checking          ||
###############################################
------------------------------------------
 [√] Service is up and running
------------------------------------------
###############################################
||       Welcome to the gsd client !         ||
###############################################
Workspaces
  - Learning Music > Todo : 4 goal(s)
  - Eventuria > Todo : 6 goal(s)
  - Sports > Todo : 3 goal(s)
------------------------------------------
Commands
   1- Create A Workspace
   2- Work On A Workspace
   3- Quit