https://github.com/kai3341/zerod

Small process control system without master process
https://github.com/kai3341/zerod

background daemonize process-manager

Last synced: about 2 months ago
JSON representation

Small process control system without master process

• Host: GitHub
• URL: https://github.com/kai3341/zerod
• Owner: kai3341
• License: bsd-3-clause
• Created: 2023-12-17T19:18:51.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-02-13T17:06:15.000Z (11 months ago)
• Last Synced: 2024-03-19T08:32:49.286Z (10 months ago)
• Topics: background, daemonize, process-manager
• Language: Shell
• Homepage:
• Size: 121 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# zerod

Small process control system without master process

This tool is designed for cases when supervisord or systemd is too heavy for you.

It should be interesting for development purpose or in running something

"without obligations"

Should work on Linux and MacOS. It's possible to make it running on other unix

# Usage

Put `zerod` script into your working directory and make it executable

Remember: `zerod` is name-agnostic: you may rename it as you want, or make

its copy or symlink

If you decided to put `zerod` script into your git repository, don't forget to

append your `.gitignore` file with `zerod.temp/` line

## `./zerod init` (getting started)

Let `zerod` to build small example config. It should create `.zerod` directory.

Then you have to open `.zerod` directory and change example `config` file:

### Zerod config

The main variable you have to set is `CMD` variable

Also you may allow `zerod` to run many instancies of `CMD` via setting `MANY=1`

Set `RESTART=1` to make `zerod` restart the process if it was stopped

You may also change other `zerod` variables. Feel free to do it

## `./zerod start`

Just start the `CMD`

## `./zerod stop`

Just stop **all** instancies of `CMD`

## `./zerod restart`

Stops **all** instancies of `CMD` and then starts once

## Zerod logs

Logs are stored in `.zerod/log` file, but I've add useful commands

![log_tail](img/log_tail.png "Zerod logs")

### `./zerod log tail`

Last log reading

### `./zerod log clear`

Clear old logs

## `./zerod ps`

List of `zerod` controlled processess. Check it after `CMD` changing

## `./zerod run`  # script

You may add your scripts into `.zerod/scripts` directory. Script working

directory will be the same as `./zerod` script is called. Environment variable

`ZEROD` is passed to script referring to previously called `./zerod` script