Re-introduce bash wrapper

Author: tvlooy

messenger.rst

@@ -645,11 +645,40 @@ FATAL (too many start retries) state when trying to restart when something is
 not yet available. You can prevent this by wrapping the Symfony script with a
 shell script and sleep when the script fails:
 
+.. code-block:: bash
+
+    #!/usr/bin/env bash
+
+    # Supervisor sends TERM to services when stopped.
+    # This wrapper has to pass the signal to it's child.
+    # Note that we send TERM (graceful) instead of KILL (immediate).
+    _term() {
+        echo "[GOT TERM, SIGNALING CHILD]"
+        kill -TERM "$child" 2>/dev/null
+        exit 1
+    }
+
+    trap _term SIGTERM
+
+    # Execute console.php with whatever arguments were specified to this script
+    "$@" &
+    child=$!
+    wait "$child"
+    rc=$?
+
+    # Delay to prevent supervisor from restarting too fast on failure
+    sleep 30
+
+    # Return with the exit code of the wrapped process
+    exit $rc
+
+The supervisor job would then look like this:
+
 .. code-block:: ini
 
     ;/etc/supervisor/conf.d/messenger-worker.conf
     [program:messenger-consume]
-    command=sh -c "/php /path/to/your/app/bin/console messenger:consume async --time-limit=3600 || (sleep 30 && false)"
+    command=/path/to/your/app/bin/console_wrapper php /path/to/your/app/bin/console messenger:consume async --time-limit=3600"
     ...
 
 .. _messenger-systemd: