hirevo / persist

A fast and simple asynchronous process manager.

persist

persist is a fast and simple asynchronous process manager.

Example

# start managing a new process.
persist start --name http-server -- serve .

# list managed processes.
persist ls
persist list

# stop the running process.
persist stop http-server

# dump the current process configurations.
persist dump --all

# restart the process.
persist restart http-server

# stop managing the process.
persist delete http-server

# restore the process from the previous dump
persist restore --all

# stop managing all processes.
persist delete --all

# stop the background deamon.
persist daemon kill

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

persist's Issues

Expose global host system information and metrics

Just as we can monitor individual processes, it could be useful to be able to also monitor the system itself and expose metrics like:

• global CPU usage (aggregated and/or per-core)
• global memory usage
• total number of processes
• etc...

Allow restoring processes from a configuration dump

Currently, persist dump exports the process configurations but there is no way to restore them from this dump directly.
We should have something like a persist restore command (naming still up in the air, right now) that reads a dump file and restores the processes in the exact same configurations.

Persist home management

It would be really interesting to be able to manage several projects with a single persistence daemon and to manage them individually.

Allow auto-restarting processes

This project is named persist but there is still no way to automatically restart a process if it stops on its own.

We should decide on:

• whether we should auto-restart by default, or not
• what conditions we should restart a process on (specific exit code, if signaled, etc...)

Allow batching multiple restarts, stops or deletes

Currently, only one process at a time may be named to restart, stop or delete in the CLI.
We should have support for restarting, stopping and deleting multiple processes in one call.
It should work the same way as persist dump.

Something like:

# multiple specific processes: OK
persist stop foo bar

# all processes: OK
persist stop --all

# no processes: ERROR
persist stop

# all processes (`--all` will take precedence): OK
persist stop --all foo