Often-times, we will want to have the container inspect output for debugging purposes, but this process is: - error prone, as the user needs to know what their containers are - potentially insecure, as the output must be sanitized of sensitive data Instead of making users wade through this process, we provide a helper `ps:inspect` command, that can be used to diagnose problems associated with containers that may or may not exist for an application.
45 lines
1.5 KiB
Bash
Executable File
45 lines
1.5 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
[[ " help ps:help " == *" $1 "* ]] || exit "$DOKKU_NOT_IMPLEMENTED_EXIT"
|
|
set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
|
|
|
|
case "$1" in
|
|
help | ps:help)
|
|
help_content_func () {
|
|
declare desc="return ps plugin help content"
|
|
cat<<help_content
|
|
ps <app>, List processes running in app container(s)
|
|
ps:inspect <app>, Displays a sanitized version of docker inspect for an app
|
|
ps:scale <app> <proc>=<count> [<proc>=<count>...], Get/Set how many instances of a given process to run
|
|
ps:start <app>, Start app container(s)
|
|
ps:startall, Starts all apps via command line
|
|
ps:stop <app>, Stop app container(s)
|
|
ps:stopall, Stop all app container(s)
|
|
ps:rebuild <app>, Rebuild an app from source
|
|
ps:rebuildall, Rebuild all apps from source
|
|
ps:report [<app>] [<flag>], Displays a process report for one or more apps
|
|
ps:restart <app>, Restart app container(s)
|
|
ps:restartall, Restart all deployed app containers
|
|
ps:restore, Start previously running apps e.g. after reboot
|
|
ps:restart-policy <app>, Shows the restart-policy for an app
|
|
ps:set-restart-policy <app> <policy>, Sets app restart-policy
|
|
help_content
|
|
}
|
|
|
|
if [[ $1 = "ps:help" ]] ; then
|
|
echo -e 'Usage: dokku ps[:COMMAND]'
|
|
echo ''
|
|
echo 'List running processes in container, and restart app.'
|
|
echo ''
|
|
echo 'Additional commands:'
|
|
help_content_func | sort | column -c2 -t -s,
|
|
else
|
|
help_content_func
|
|
fi
|
|
;;
|
|
|
|
*)
|
|
exit "$DOKKU_NOT_IMPLEMENTED_EXIT"
|
|
;;
|
|
|
|
esac
|