Utilização

Instalar Moleculer

Moleculer pode ser instalado com npm ou yarn.

$ npm i moleculer --save

Crie o seu primeiro microsserviço

Este exemplo básico mostra como criar um pequeno serviço math para adicionar dois números e chamá-lo localmente.

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

// Cria um ServiceBroker
const broker = new ServiceBroker();

// Define um serviço
broker.createService({
    name: "math",
    actions: {
        add(ctx) {
            return Number(ctx.params.a) + Number(ctx.params.b);
        }
    }
});

// Inicia o broker
broker.start()
    // Chama o serviço
    .then(() => broker.call("math.add", { a: 5, b: 3 }))
    // Exibe a resposta
    .then(res => console.log("5 + 3 =", res))
    .catch(err => console.error(`Error occured! ${err.message}`));
Experimente em seu navegador!

Abra este exemplo no Runkit!

Criar um projeto Moleculer

Neste exemplo, usamos a ferramenta oficial Moleculer CLI para criar um novo projeto de microsserviços baseado em Moleculer com um serviço de exemplo e uma API Gateway para chamá-lo do navegador via REST API.

  1. Instale moleculer-cli globalmente

    $ npm i moleculer-cli -g

  2. Criar um novo projeto (chamado moleculer-demo)

    $ moleculer init project moleculer-demo

    Pressione ENTER para todas as perguntas (aceite as respostas sugeridas)

    Não se esqueça de instalar e iniciar o Servidor NATS. Caso contrário, você receberá o seguinte erro:
    erro NATS. Não foi possível conectar ao servidor: Error: connect ECONNREFUSED 127.0.0.1:4222

  3. Abrir pasta do projeto

    $ cd moleculer-demo

  4. Iniciar projeto

    $ npm run dev
  1. Abra o link http://localhost:3000/ no seu navegador. Uma página inicial será exibida contendo dois links para chamar o serviço greeter via API gateway.
Parabéns!

Você acabou de criar seu primeiro projeto de microsserviços baseado em Moleculer! Em seguida, confira a página de conceitos básicos do Moleculer para se familiarizar com eles e ver como eles se encaixam juntos. Caso contrário, confira nossos exemplos ou projetos de demonstração.

Você também pode verificar o vídeo abaixo que explica o funcionamento do projeto que você acabou de criar.

Moleculer Demo Playground

Se você não deseja instalar moleculer-demo em seu computador, você pode usar o playground.