DOORMAN

a Procfile runner / foreman clone for BASH

usage:

  $ doorman.sh [-h❘--help]
  $ doorman.sh [-v❘--version]
  $ doorman.sh [-p PROCFILE] [[-e ENVFILE] ꓺ] [-d PATH] [-f❘-w] [-r [MAXTRIES]] [-t [SECONDS]]

available options:

• -p, --procfile=PROCFILE Specify an alternate Procfile to use instead of '$PATH/Procfile'.

• -e, --env=ENVFILE Specify additional DotEnv ('.env') files to load after '$PATH/.env'.

• -d, --directory=PATH Specify an alternate directory to use as the root directory, which will be used as the directory where commands in the Procfile will be executed, and where '.env' files will be searched for.
  The default root directory is the directory containing the Procfile.

• -f, --fail-one Shut down when ANY process exits, terminating remaining processes.

• -w, --wait-all Shut down only after ALL processes have exited. This is the default mode.

• -r, --restart[=MAXTRIES] Restart processes which have exited, with an optional limit on the maximum tries.
  When the argument is present with the optional MAXTRIES parameter omitted, the value defaults to 0, which means no restart limit.
  Otherwise Doorman lets processes fail after running them MAXTRIES times. Without the --restart argument, each process runs only once.

• -t, --timeout[=SECONDS] Set a shutdown timeout in seconds each process is given to terminate before being sent a KILL signal in the event of Doorman shutting down.
  When the argument is present with the optional SECONDS parameter omitted, the timeout defaults to 3 seconds. Without the --timeout argument, processes are KILLed immediately.

Contributing

Contributions, issues and feature requests are welcome.

Feel free to check issues page, if you want to contribute.

Author

Raziel Anarki

• GitHub: razielanarki
• Facebook: facebook.com/razielanarki
• Email: razielanarki-AT-semmi-DOT-se

License

Copyright © 2020-2023 Raziel Anarki

This project is licensed under the MIT license.