celerybeat 8.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325
  1. #!/bin/sh -e
  2. # =========================================================
  3. # celerybeat - Starts the Celery periodic task scheduler.
  4. # =========================================================
  5. #
  6. # :Usage: /etc/init.d/celerybeat {start|stop|force-reload|restart|try-restart|status}
  7. # :Configuration file: /etc/default/celerybeat or /etc/default/celeryd
  8. #
  9. # See http://docs.celeryproject.org/en/latest/tutorials/daemonizing.html#generic-init-scripts
  10. ### BEGIN INIT INFO
  11. # Provides: celerybeat
  12. # Required-Start: $network $local_fs $remote_fs
  13. # Required-Stop: $network $local_fs $remote_fs
  14. # Default-Start: 2 3 4 5
  15. # Default-Stop: 0 1 6
  16. # Short-Description: celery periodic task scheduler
  17. ### END INIT INFO
  18. # Cannot use set -e/bash -e since the kill -0 command will abort
  19. # abnormally in the absence of a valid process ID.
  20. #set -e
  21. VERSION=10.1
  22. echo "celery init v${VERSION}."
  23. if [ $(id -u) -ne 0 ]; then
  24. echo "Error: This program can only be used by the root user."
  25. echo " Unpriviliged users must use 'celery beat --detach'"
  26. exit 1
  27. fi
  28. # May be a runlevel symlink (e.g. S02celeryd)
  29. if [ -L "$0" ]; then
  30. SCRIPT_FILE=$(readlink "$0")
  31. else
  32. SCRIPT_FILE="$0"
  33. fi
  34. SCRIPT_NAME="$(basename "$SCRIPT_FILE")"
  35. # /etc/init.d/celerybeat: start and stop the celery periodic task scheduler daemon.
  36. # Make sure executable configuration script is owned by root
  37. _config_sanity() {
  38. local path="$1"
  39. local owner=$(ls -ld "$path" | awk '{print $3}')
  40. local iwgrp=$(ls -ld "$path" | cut -b 6)
  41. local iwoth=$(ls -ld "$path" | cut -b 9)
  42. if [ "$(id -u $owner)" != "0" ]; then
  43. echo "Error: Config script '$path' must be owned by root!"
  44. echo
  45. echo "Resolution:"
  46. echo "Review the file carefully and make sure it has not been "
  47. echo "modified with mailicious intent. When sure the "
  48. echo "script is safe to execute with superuser privileges "
  49. echo "you can change ownership of the script:"
  50. echo " $ sudo chown root '$path'"
  51. exit 1
  52. fi
  53. if [ "$iwoth" != "-" ]; then # S_IWOTH
  54. echo "Error: Config script '$path' cannot be writable by others!"
  55. echo
  56. echo "Resolution:"
  57. echo "Review the file carefully and make sure it has not been "
  58. echo "modified with malicious intent. When sure the "
  59. echo "script is safe to execute with superuser privileges "
  60. echo "you can change the scripts permissions:"
  61. echo " $ sudo chmod 640 '$path'"
  62. exit 1
  63. fi
  64. if [ "$iwgrp" != "-" ]; then # S_IWGRP
  65. echo "Error: Config script '$path' cannot be writable by group!"
  66. echo
  67. echo "Resolution:"
  68. echo "Review the file carefully and make sure it has not been "
  69. echo "modified with malicious intent. When sure the "
  70. echo "script is safe to execute with superuser privileges "
  71. echo "you can change the scripts permissions:"
  72. echo " $ sudo chmod 640 '$path'"
  73. exit 1
  74. fi
  75. }
  76. scripts=""
  77. if test -f /etc/default/celeryd; then
  78. scripts="/etc/default/celeryd"
  79. _config_sanity /etc/default/celeryd
  80. . /etc/default/celeryd
  81. fi
  82. EXTRA_CONFIG="/etc/default/${SCRIPT_NAME}"
  83. if test -f "$EXTRA_CONFIG"; then
  84. scripts="$scripts, $EXTRA_CONFIG"
  85. _config_sanity "$EXTRA_CONFIG"
  86. . "$EXTRA_CONFIG"
  87. fi
  88. echo "Using configuration: $scripts"
  89. CELERY_BIN=${CELERY_BIN:-"celery"}
  90. DEFAULT_USER="celery"
  91. DEFAULT_PID_FILE="/var/run/celery/beat.pid"
  92. DEFAULT_LOG_FILE="/var/log/celery/beat.log"
  93. DEFAULT_LOG_LEVEL="INFO"
  94. DEFAULT_CELERYBEAT="$CELERY_BIN beat"
  95. CELERYBEAT=${CELERYBEAT:-$DEFAULT_CELERYBEAT}
  96. CELERYBEAT_LOG_LEVEL=${CELERYBEAT_LOG_LEVEL:-${CELERYBEAT_LOGLEVEL:-$DEFAULT_LOG_LEVEL}}
  97. CELERYBEAT_SU=${CELERYBEAT_SU:-"su"}
  98. CELERYBEAT_SU_ARGS=${CELERYBEAT_SU_ARGS:-""}
  99. # Sets --app argument for CELERY_BIN
  100. CELERY_APP_ARG=""
  101. if [ ! -z "$CELERY_APP" ]; then
  102. CELERY_APP_ARG="--app=$CELERY_APP"
  103. fi
  104. CELERYBEAT_USER=${CELERYBEAT_USER:-${CELERYD_USER:-$DEFAULT_USER}}
  105. # Set CELERY_CREATE_DIRS to always create log/pid dirs.
  106. CELERY_CREATE_DIRS=${CELERY_CREATE_DIRS:-0}
  107. CELERY_CREATE_RUNDIR=$CELERY_CREATE_DIRS
  108. CELERY_CREATE_LOGDIR=$CELERY_CREATE_DIRS
  109. if [ -z "$CELERYBEAT_PID_FILE" ]; then
  110. CELERYBEAT_PID_FILE="$DEFAULT_PID_FILE"
  111. CELERY_CREATE_RUNDIR=1
  112. fi
  113. if [ -z "$CELERYBEAT_LOG_FILE" ]; then
  114. CELERYBEAT_LOG_FILE="$DEFAULT_LOG_FILE"
  115. CELERY_CREATE_LOGDIR=1
  116. fi
  117. export CELERY_LOADER
  118. CELERYBEAT_OPTS="$CELERYBEAT_OPTS -f $CELERYBEAT_LOG_FILE -l $CELERYBEAT_LOG_LEVEL"
  119. if [ -n "$2" ]; then
  120. CELERYBEAT_OPTS="$CELERYBEAT_OPTS $2"
  121. fi
  122. CELERYBEAT_LOG_DIR=`dirname $CELERYBEAT_LOG_FILE`
  123. CELERYBEAT_PID_DIR=`dirname $CELERYBEAT_PID_FILE`
  124. # Extra start-stop-daemon options, like user/group.
  125. CELERYBEAT_CHDIR=${CELERYBEAT_CHDIR:-$CELERYD_CHDIR}
  126. if [ -n "$CELERYBEAT_CHDIR" ]; then
  127. DAEMON_OPTS="$DAEMON_OPTS --workdir=$CELERYBEAT_CHDIR"
  128. fi
  129. export PATH="${PATH:+$PATH:}/usr/sbin:/sbin"
  130. check_dev_null() {
  131. if [ ! -c /dev/null ]; then
  132. echo "/dev/null is not a character device!"
  133. exit 75 # EX_TEMPFAIL
  134. fi
  135. }
  136. maybe_die() {
  137. if [ $? -ne 0 ]; then
  138. echo "Exiting: $*"
  139. exit 77 # EX_NOPERM
  140. fi
  141. }
  142. create_default_dir() {
  143. if [ ! -d "$1" ]; then
  144. echo "- Creating default directory: '$1'"
  145. mkdir -p "$1"
  146. maybe_die "Couldn't create directory $1"
  147. echo "- Changing permissions of '$1' to 02755"
  148. chmod 02755 "$1"
  149. maybe_die "Couldn't change permissions for $1"
  150. if [ -n "$CELERYBEAT_USER" ]; then
  151. echo "- Changing owner of '$1' to '$CELERYBEAT_USER'"
  152. chown "$CELERYBEAT_USER" "$1"
  153. maybe_die "Couldn't change owner of $1"
  154. fi
  155. if [ -n "$CELERYBEAT_GROUP" ]; then
  156. echo "- Changing group of '$1' to '$CELERYBEAT_GROUP'"
  157. chgrp "$CELERYBEAT_GROUP" "$1"
  158. maybe_die "Couldn't change group of $1"
  159. fi
  160. fi
  161. }
  162. check_paths() {
  163. if [ $CELERY_CREATE_LOGDIR -eq 1 ]; then
  164. create_default_dir "$CELERYBEAT_LOG_DIR"
  165. fi
  166. if [ $CELERY_CREATE_RUNDIR -eq 1 ]; then
  167. create_default_dir "$CELERYBEAT_PID_DIR"
  168. fi
  169. }
  170. create_paths () {
  171. create_default_dir "$CELERYBEAT_LOG_DIR"
  172. create_default_dir "$CELERYBEAT_PID_DIR"
  173. }
  174. is_running() {
  175. pid=$1
  176. ps $pid > /dev/null 2>&1
  177. }
  178. wait_pid () {
  179. pid=$1
  180. forever=1
  181. i=0
  182. while [ $forever -gt 0 ]; do
  183. if ! is_running $pid; then
  184. echo "OK"
  185. forever=0
  186. else
  187. kill -TERM "$pid"
  188. i=$((i + 1))
  189. if [ $i -gt 60 ]; then
  190. echo "ERROR"
  191. echo "Timed out while stopping (30s)"
  192. forever=0
  193. else
  194. sleep 0.5
  195. fi
  196. fi
  197. done
  198. }
  199. stop_beat () {
  200. echo -n "Stopping ${SCRIPT_NAME}... "
  201. if [ -f "$CELERYBEAT_PID_FILE" ]; then
  202. wait_pid $(cat "$CELERYBEAT_PID_FILE")
  203. else
  204. echo "NOT RUNNING"
  205. fi
  206. }
  207. _chuid () {
  208. ${CELERYBEAT_SU} ${CELERYBEAT_SU_ARGS} \
  209. "$CELERYBEAT_USER" -c "$CELERYBEAT $*"
  210. }
  211. start_beat () {
  212. echo "Starting ${SCRIPT_NAME}..."
  213. _chuid $CELERY_APP_ARG $CELERYBEAT_OPTS $DAEMON_OPTS --detach \
  214. --pidfile="$CELERYBEAT_PID_FILE"
  215. }
  216. check_status () {
  217. local failed=
  218. local pid_file=$CELERYBEAT_PID_FILE
  219. if [ ! -e $pid_file ]; then
  220. echo "${SCRIPT_NAME} is down: no pid file found"
  221. failed=true
  222. elif [ ! -r $pid_file ]; then
  223. echo "${SCRIPT_NAME} is in unknown state, user cannot read pid file."
  224. failed=true
  225. else
  226. local pid=`cat "$pid_file"`
  227. local cleaned_pid=`echo "$pid" | sed -e 's/[^0-9]//g'`
  228. if [ -z "$pid" ] || [ "$cleaned_pid" != "$pid" ]; then
  229. echo "${SCRIPT_NAME}: bad pid file ($pid_file)"
  230. failed=true
  231. else
  232. local failed=
  233. kill -0 $pid 2> /dev/null || failed=true
  234. if [ "$failed" ]; then
  235. echo "${SCRIPT_NAME} (pid $pid) is down, but pid file exists!"
  236. failed=true
  237. else
  238. echo "${SCRIPT_NAME} (pid $pid) is up..."
  239. fi
  240. fi
  241. fi
  242. [ "$failed" ] && exit 1 || exit 0
  243. }
  244. case "$1" in
  245. start)
  246. check_dev_null
  247. check_paths
  248. start_beat
  249. ;;
  250. stop)
  251. check_paths
  252. stop_beat
  253. ;;
  254. reload|force-reload)
  255. echo "Use start+stop"
  256. ;;
  257. status)
  258. check_status
  259. ;;
  260. restart)
  261. echo "Restarting celery periodic task scheduler"
  262. check_paths
  263. stop_beat
  264. check_dev_null
  265. start_beat
  266. ;;
  267. create-paths)
  268. check_dev_null
  269. create_paths
  270. ;;
  271. check-paths)
  272. check_dev_null
  273. check_paths
  274. ;;
  275. *)
  276. echo "Usage: /etc/init.d/${SCRIPT_NAME} {start|stop|restart|create-paths|status}"
  277. exit 64 # EX_USAGE
  278. ;;
  279. esac
  280. exit 0