/moleculer-realworld-example-app

:earth_asia: RealWorld example app with Moleculer microservices framework

Primary LanguageJavaScriptMIT LicenseMIT

RealWorld Example App

Moleculer codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This repo is functionality complete — PRs and issues welcome!

Live demo on Glitch: https://realworld-moleculer.glitch.me

Glitch project: https://glitch.com/edit/#!/realworld-moleculer

React + Redux front-end UI is included. For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

Getting started

To get the Node server running locally:

  • Clone this repo
  • npm install to install all required dependencies
  • npm run dev to start the local server
  • the API is available at http://localhost:3000/api

Alternately, to quickly try out this repo in the cloud, you can

Remix on Glitch

MongoDB persistent store

Basically the services stores data in an NeDB persistent file storage in the ./data folder. If you have to use MongoDB, set the MONGO_URI environment variable.

MONGO_URI=mongodb://localhost/conduit

Multiple instances

You can run multiple instances of services. In this case you need to use a transporter i.e.: NATS. NATS is a lightweight & fast message broker. Download it and start with gnatsd command. After it started, set the TRANSPORTER env variable and start services.

TRANSPORTER=nats://localhost:4222

To get the Node server running locally with Docker

  1. Checkout the repo git clone https://github.com/ice-services/moleculer-realworld-example-app.git

  2. cd moleculer-realworld-example-app

  3. Start with docker-compose: docker-compose up -d

    It starts all services in separated containers, a NATS server for communication, a MongoDB server for database and a Traefik reverse proxy

  4. Open the http://docker-ip:3000

  5. Scale up services

    docker-compose scale api=3 articles=2 users=2 comments=2 follows=2 favorites=2

Code Overview

Dependencies

Application Structure

  • moleculer.config.js - Moleculer ServiceBroker configuration file.
  • services/ - This folder contains the services.
  • public/ - This folder contains the front-end static files.
  • data/ - This folder contains the NeDB database files.

Test

Tested with realworld-server-tester.

Local tests is missing currently.

$ npm test

In development with watching

$ npm run ci

License

This project is available under the MIT license.

Contact

Copyright (c) 2016-2017 Ice-Services

@ice-services @MoleculerJS