https://github.com/lblod/app-hackathon-team-4-permits

https://github.com/lblod/app-hackathon-team-4-permits

Last synced: 22 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/lblod/app-hackathon-team-4-permits
• Owner: lblod
• License: mit
• Created: 2024-09-11T11:40:23.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-09-13T13:01:02.000Z (3 months ago)
• Last Synced: 2024-09-14T01:47:24.955Z (3 months ago)
• Language: Python
• Size: 7.58 MB
• Stars: 0
• Watchers: 5
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# mu-project

Bootstrap a mu.semte.ch microservices environment in three easy steps.

## Quickstart an mu-project

> [INFO]

> This project was created by running `mu project new awesome-project-name`.  If read on GitHub under mu-semtech/mu-project then it is the template repository for a new project, use `mu project new` instead.

Setting up your environment is done in three easy steps:

1. First configure the running microservices and their names in `docker-compose.yml`

2. Then, configure how requests are dispatched in `config/dispatcher.ex`

3. Lastly, simply start the docker-compose.

### Hooking things up with docker-compose

Alter the `docker-compose.yml` file so it contains all microservices you need.  The example content should be clear, but you can find more information in the [Docker Compose documentation](https://docs.docker.com/compose/).  Don't remove the `identifier` and `db` container, they are respectively the entry-point and the database of your application.  Don't forget to link the necessary microservices to the dispatcher and the database to the microservices.

### Configure the dispatcher

Next, alter the file `config/dispatcher/dispatcher.ex` based on the example that is there by default.  Dispatch requests to the necessary microservices based on the names you used for the microservice.

### Boot up the system

Boot your microservices-enabled system using docker-compose.

    cd /path/to/mu-project

    docker-compose up

You can shut down using `docker-compose stop` and remove everything using `docker-compose rm`.