Simplest possible job manager.
Any executable file in any subdirectory under <working_directory>/config/jobs will be considered a job. The path to the executable will be the name of the job. Jobs are executed by executing the file in its own directory. The logs of the execution are captured and stored.
The default UI and the HTTP API allow exploring jobs, executions, logs, and triggering new executions.
Jobs are executed with the same environment and user used to start Servitor. For example: Starting Servitor with the root user means that the jobs execute as root aswell, without limitations. Plan accordingly.
Servitor exposes an HTTP API through a UNIX socket on <working_directory>/sockets/servitor.sock. Servitor implements no authentication nor authorization of any kind, which means that a process that can communicate with servitor.sock can do anything that the API allows, unrestricted. This socket is created with the permissions 770 to limit the access to the same user and group executing Servitor.
When Servitor receives a SIGINT or a SIGTERM, it will shut down the HTTP server immediately, and will wait for any running jobs to finish before shutting down completely.
While discovering and executing jobs, symlinks will be followed.
Servitor depends exclusively on Python 3 and makes no assumptions on how your system works. You can clone this repository, run the command below, and you will have a UNIX socket in sockets/servitor.sock ready to accept HTTP requests.
PYTHONPATH=src/python SERVITOR_UI_ROOT=src/ui python3 -m servitorThere is an installer available that will install Servitor as a service, create a user if needed, and leave it running.
curl -L https://raw.githubusercontent.com/sirikon/servitor/master/scripts/servitor-installer.sh | bashIt makes some assumptions about your system. If those work for you, use it. If not, go the manual way.
To update a Servitor installation, just run the installer again with the same parameters.
Available environment variables to configure the installer at execution:
SERVITOR_USER(default:root): Change the user that will run the Servitor systemd service. It will create the user if it doesn't exist yet.SERVITOR_UMASK(default:0077): Change the UMask value configured for the Servitor systemd service. By default it is0077so everything Servitor creates is only visible for the Servitor user, making exposing files to other users an explicit act.
Available environment variables to configure servitor at execution:
SERVITOR_UI_ROOT(default: empty): If defined, the specified filesystem path is served under the root HTTP path (/). This is intended to provide a way to serve alternative UIs or to disable the UI completely. If the environment variable stays undefined, no UI will be served at the root HTTP path, and the server will reply with404 Not Found.