Serv creates, removes and manages services on multiple init systems (process managers? service managers? can someone come up with a normal name for this? jeez.)

Serv is a Pythonic spinoff of Jordan Sissel's brilliant pleaserun. The question that Serv tries to answer is: "Why the hell do I have to know init systems? I just want this to run forever."

• Abstracts away the platform (systemd, upstart, etc..) - Serv identifies it by itself thought it can be explicitly provided.
• Creates service configuration files on different platforms so that you don't have to.
• Allows to deploy services after generating the config on the local machine.
• Allows to stop and remove services.
• Provides both an API and CLI for those purposes.
• Provides an API for retrieving service related information.

NOTE: Serv requires sudo permissions! (you can't write to /etc/init.d, /lib/systemd/system and the others without root can ya?)

systemd, Upstart and SysV are mostly supported now though SysV doesn't yet support retrieving a service's status. nssm (Non-Sucking Service Manager for Windows) is currently being worked on.

I intend to add:

• runit
• supervisord
• Whichever other system that's giving you (or me) a headache.

Note: On Linux, Serv uses ld to identify the distribution.

sudo pip install serv

For dev:

sudo pip install https://github.com/nir0s/serv/archive/master.tar.gz

Before using, please read the caveats section!

$ sudo serv generate /usr/bin/python2 --name MySimpleHTTPServer --args '-m SimpleHTTPServer' --var KEY1=VALUE1 --var KEY2=VALUE2 --deploy --start
...

INFO - Generating files for systemd...
INFO - Generated /tmp/SimpleHTTPServer.service
INFO - Generated /tmp/SimpleHTTPServer
INFO - Deploying systemd service SimpleHTTPServer...
INFO - Deploying /tmp/SimpleHTTPServer.service to /lib/systemd/system/SimpleHTTPServer.service...
INFO - Deploying /tmp/SimpleHTTPServer to /etc/sysconfig/SimpleHTTPServer...
INFO - Starting systemd service SimpleHTTPServer...
INFO - Service created.


...

$ ss -lntp | grep 8000
LISTEN     0      5            *:8000                     *:*

If name is omitted, the name of the service (and therefore, the names of the files) will be deduced from the executable's name.

$ sudo serv status MySimpleHTTPServer
...

{
    "init_system": "systemd",
    "init_system_version": "default",
    "services": [
        {
            "active": "active",
            "description": "no",
            "load": "loaded",
            "name": "MySimpleHTTPServer.service",
            "sub": "running"
        }
    ]
}

...

or for all services

$ sudo serv status
...

$ sudo serv remove MySimpleHTTPServer
...

INFO - Removing Service: SimpleHTTPServer...
INFO - Service removed.
...

$ ss -lntp | grep 8000

raise NotImplementedError()

Kidding.. it's there.. and requires documentation.

Serv, unless explicitly specified by the user, looks up the the platform you're running on (Namely, linux distro and release) and deduces which init system is running on it by checking a static mapping table or an auto-lookup mechanism.

Once an init-system matching an existing implementation (i.e supported by Serv) is found, Serv generates template files based on a set of parameters and deploys them to the relevant directories.

• Init system identification is not robust. It relies on some assumptions (and as we all know, assumption is the mother of all fuckups). Some OS distributions have multiple init systems (Ubuntu 14.04 has Upstart, SysV and half (HALF!?) of systemd).
• Stupidly enough, I have yet to standardize the status JSON returned and it is different for each init system.
• Currently if anything fails during service creation, cleanup is not performed. This will be added in future versions.

In some situations, directories related to the specific init system do not exist and should be created. For instance, even if systemd (systemctl) is available, /etc/sysconfig does not exist. IT IS UP TO THE USER to create those directories if they don't exist as Serv should not change the system on that level. The exception to the rule is with nssm, which will create the required dir (c:\nssm) for it to operate.

Required dirs are:

• /lib/systemd/system
• /etc/sysconfig (required only if environment variables are provided.)

• /etc/init.d
• /etc/default

• /etc/init

git clone git@github.com:nir0s/serv.git
cd ld
pip install tox
tox

Pull requests are always welcome to deal with specific distributions or just for general merriment.

• Under serv/init, add a file named <init_system_name>.py (e.g. runit.py).
• Implement a class named <init_system_name> (e.g. Runit). See systemd as a reference implementation.
• Pass the Base class which contains some basic parameter declarations and provides a method for generating files from templates to your class (e.g. from serv.init.base import Base).
• Add the relevant template files to serv/init/templates. The file names should be formatted as: <init_system_name>_<init_system_version>.*.j2 (e.g. runit_default.j2).
• In serv/init/init.py, import the class you implemented (e.g. from serv.init.runit import Runit).