Skip to content

nullivex/ndt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ndt

ndt is a Daemon Tools wrapper for NodeJS that will create, remove, and upgrade the daemon tools folder structure. Where <action> is from the list below.

Usage

Basic app usage

$ sudo su -
$ npm -g install ndt
$ cd /opt/myapp
$ ndt install
$ ndt <action>
$ ndt remove

Database Support

ndt Also supports saving instances to a local database so commands can be ran from anywhere. Also allows use of macros. Where <action> is from the list below.

$ cd /opt/myapp
$ ndt save
$ cd /
$ ndt myapp <action>
$ ndt unsave myapp

Macros

These functions affect all members of the database. Where <action> is from the list of actions below.

$ ndt all <action>

Actions

The following actions are available when using ndt commands that support <action>

  • alarm - Send instance an alarm
  • continue - Continue a paused instance
  • exit - Have supervise exit after instance ends (not for production)
  • hangup - Tell an instance to hangup
  • interrupt - Send instance an interrupt
  • kill - Kill an instance
  • once - Run an instance once and dont restart if it dies
  • pause - Pause an instance
  • restart - Restart an instance
  • start - Start an instance
  • status - Get instance status
  • stop - Stop an instance

dt.json

In order for an application to work with ndt.

{
  "name": "myapp"
  "cwd": "/opt/myapp",
  "user": "node",
  "command": "node app -vv"
  "env": {
    "NODE_ENV": "production",
    "DEBUG": "*"
  },
  "log": {
    "user": "node",
    "command": "multilog s16777215 t /var/log/node/myapp"
  }
}

Generating the dt.json

It is possible to generate the dt.json file in order to make the setup process a bit less cumbersome.

In order to properly populate the environment variables. We recommend piping them through stdin.

EG:

$ su - node
$ cd /opt/myapp
$ env | ndt generate --command "node app -vv" --stdin

Debugging

This package is built using the https://www.npmjs.org/package/debug package.

Use the following to see debug output

$ cd /opt/myapp
$ DEBUG=ndt* ndt install

Changelog

1.0.6

  • Fix main field

1.0.5

  • Latest dependencies
  • Update package json

1.0.4

  • Update to latest commander
  • Fix to default listing

1.0.3

  • Fix handling of default command due to a change in commander

1.0.2

  • Fix included daemontools template to use setuidgid instead of envuidgid

1.0.1

  • Fix update with ndt status not listing status and producing errors
  • Fix issue with list command not being called with no arguments

1.0.0

  • Update dependencies
  • Add support for latest Node.js versions
  • Drop support for Node.js < 4.x
  • Bump to 1.0.0 for a stable perpetual release marking 2 years with ndt in production.

0.3.0

  • Major refactor of the internal code
  • Added macro actions such as ndt all stop
  • Database is now stored globally in /etc/ndt/ndt.json
  • Confirmation of all commands working

0.2.0

  • Completion of features and testing
  • Restart now waits for process exit
  • Removal now waits for process exit
  • Database support

0.1.0

  • Initial release