Code Monkey home page Code Monkey logo

andever's Introduction

AndEver

A minimalistic daemonizer that will run your Node apps forever and ever!

Installing

npm install --save andever

In your package.json, you can now add:

{
	"scripts": {
		"start": "andever start",
		"restart": "andever restart",
		"stop": "andever stop"
	}
}

Now you can control your app's lifecycle by running npm start, npm restart and npm stop.

Why another process manager?

Short answer: because all the other ones give me headaches.

Long answer:

If you want to use PM2 or Forever and you really are happy with them, please use them. This is not for you. I have my own reasons though, and I'll try to sum them up quickly here:

  1. A simple process manager should be a very simple solution. Right now, PM2 has become so bloated the amount of code and dependencies it adds to your project are probably bigger than your project itself. I just wanna daemonize! PM2 is well maintained, but has become bloatware.
  2. Forever on the other hand is abandonware. The number of unaddressed issues has reached such a point that I using forever makes me lose sleep at night.
  3. Forever just never seems to work for me. The fact that I can run "forever start myapp" multiple times and have it not complain is a major frustration for me.

It's time for something new

Let's do this the substack way. AndEver is a 0-dependency solution to solve just one thing: daemonization of your Node app. Nothing fancy. Just a nice and simple solution.

But I want...

  • ... lists of all processes that are running! Run ps.
  • ... it to do stuff that has nothing to do with daemonization! Yeah... no.
  • Alright, make an issue and we'll talk about it. But we're not going to bloat AndEver with useless bells and whistles.

Usage

AndEver usage: andever <command> [path]

  command:
	start:   daemonizes the app
	restart: restarts the daemonized app
	stop:    stops the daemonized app
	status:  outputs the status of the running app (exit codes: 0 = running, 1 = not running)
  path:      the path to your Node.js app (default: the current working directory)

Behavior

When running AndEver to boot your app, it will run a copy of itself in the background that will only have one responsibility: restarting your app if it unexpectedly goes down. However, if it goes down with an exit code 0 or because of a signal it received, we don't restart it.

When the process is started up, its PID is written to its root folder in a file called .andever.pid. This file will be used by the other commands (restart, stop and status).

AndEver does not take care of your cluster setup. We feel that this is the responsibility of the cluster management code, not the daemonizer, and so we have not bloated AndEver with such logic. There is no cluster logic to be found here.

License

MIT, enjoy.

andever's People

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.