New release is coming soon! If you want to try out the latest features, simply run npm i -s moleculer@next. The docs for the latest version are available here.

Использование

Установка Moleculer

Moleculer может быть установлен с помощью npm или yarn.

$ npm i moleculer --save

Создайте свой первый микросервис

Этот простой пример показывает, как создать маленький сервис math для сложения двух чисел и локального вызова.

const { ServiceBroker } = require("moleculer");

// создание брокера
const broker = new ServiceBroker();

// определение сервиса
broker.createService({
name: "math",
actions: {
add(ctx) {
return Number(ctx.params.a) + Number(ctx.params.b);
}
}
});

// запуск брокера
broker.start()
// вызов сервиса
.then(() => broker.call("math.add", { a: 5, b: 3 }))
// вывод ответа
.then(res => console.log("5 + 3 =", res))
.catch(err => console.error(`Error occured! ${err.message}`));
Try it in your browser!

Откройте этот пример на Runkit!

Создание проекта Moleculer

В этом примере мы используем официальный консольную программу Moleculer CLI для создания нового микросервисного проекта с сервисом и API шлюзом для вызова его из браузера через REST API.

  1. Установите moleculer-cli глобально

    $ npm i moleculer-cli -g
  2. Создать новый проект (с именем moleculer-demo)

    $ moleculer init project moleculer-demo

    Press ENTER to all questions (accept default answers)

    Don’t forget to install and start NATS Server. Иначе вы получите следующую ошибку:
    NATS error. Could not connect to server: Error: connect ECONNREFUSED 127.0.0.1:4222

  3. Откройте папку проекта

    $ cd moleculer-demo
  4. Запустите проект

    $ npm run dev
  1. Откройте ссылку http://localhost:3000/ в вашем браузере. Он покажет стартовую страницу, которая содержит две ссылки для вызова службы greeter через API шлюз.
Поздравляем!

Вы только что создали свой первый проект на основе микросервисов Moleculer! Далее посмотрите страницу основы работы Moleculer, чтобы познакомиться с ними и посмотреть, как они взаимодействуют друг с другом. Или изучите наши примеры и демо проекты.

Вы также можете посмотреть видео ниже, в котором объясняются устройство только что созданного проекта.

Moleculer демонстрационная площадка

Если вы не хотите устанавливать на свой компьютер moleculer-demo, то вы можете использовать интерактивную игровую площадку.