jarvusinnovations/background-action

Background commands with log tailing/capture; waits until file/port/socket/http are ready to proceed. Isolates/dedupe errors.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
runcommands to run, supports multi-line commands (to background multiple processes, use & at the end of each line)yes—
working-directorythe current working directory for the shell running the commandsno—
wait-onresources to wait on -- separated by commas or newlines, supported prefixes: [file,http,https,http-get,https-get,tcp,socket] (for advanced usage, pass a JSON serialized wait-on config)yes—
wait-forduration to wait for resources to be available (specify unit postfix, defaults to ms)—30s
tailtail log output while waiting on resources to be available [stderr,stdout,true,false]—true
log-outputspecify which logs (stdout,stderr) to output post-run (after the run has completed or failed) (stderr,stdout,true,false)—stdout,stderr
log-output-resumetruncate tailed stderr/stdout output from post-run logs (i.e. deduplicate log output) [stderr,stdout,true,false]—false
log-output-ifcontrol if post-run logging occurs (timeout,exit-early,failure,success,true,false)—true
shutdownsend SIGTERM to the backgrounded process group during post-run and wait for it to exit, so shutdown output is captured and nothing is left holding ports—true
shutdown-gracehow long to wait for the backgrounded process group to exit before sending SIGKILL (specify unit postfix, defaults to ms)—10s
namedescription
stdout-logpath to the file capturing stdout from the run (under RUNNER_TEMP)
stderr-logpath to the file capturing stderr from the run (under RUNNER_TEMP)