Mozzart

Use it to run, watch and restart all your node apps with just one command.

Very useful when developping on a microservices architecture.

Installation

npm install -g mozzart

Add sudo if you don't have rights on your system.

Command Line Usage

$ mozzart [action]

actions:
  start           Start all processes found in config file. Default action when non one given
  list            List all processes, running or not with their <uid> and <pid>
  log <uid>       Will output logs for the process <uid>
  resume <uid>    Resume the process referenced by <uid> when it has been manually stopped
  stop <uid>      Stop the process referenced by <uid>
  restart <uid>   Stop (if running) and resume <uid>
  remove <uid>    Stop <uid> and remove it from list. Keep it in config file
  update          Reread config file and stop or start diff
  version         Show current Mozzart version

options:
  -c, --config  The path where config file is located. Absolute or relative from current working dir

See configuration for more informations.

Configuration

There are 3 ways to give a configuration to Mozzart. In this order, as soon as one exists, Mozzart takes it and stops looking :

• With a command line configuration argument --config my-config.js
• With a .mozzart.js file in the directory you execute mozzart
• With a .mozzart.js file in your home directory

Options

processes

Type	Default value
<Array>	[]

The list of processes that Mozzart will run. Each process have these params :

Param	Required	Default	Description
cwd	true		Directory path where is file
file	true		Filename to execute
arguments	false	[]	List of coma separated command line arguments
watch	false	config.watch	Watch for file changes in cwd ?
sync	false	false	Waiting for PROCESS_READY msg to run next

silent

Type	Default value
<Boolean>	false

watch

Type	Default value
<Boolean>	true

Default value for all processes watch param.

prefixTS

Type	Default value
<Boolean>	true

If enabled Mozzart will prefix every log line with date and time.

Example

~/.mozzart.js

'use strict';

module.exports = {
  processes : [
    {
      cwd  : `~/project/service-1`,
      file : `app.js`,
    },
    {
      cwd  : `~/project/router`,
      file : `index.js`,
    },
    {
      cwd       : `~/project/logger`,
      file      : `app.js`,
      arguments : [`--verbose`]
    },
  ],
};