potiuk commented on a change in pull request #18068:
URL: https://github.com/apache/airflow/pull/18068#discussion_r706326267
##########
File path: docs/docker-stack/entrypoint.rst
##########
@@ -161,6 +161,34 @@ If there are any other arguments - they are simply passed
to the "airflow" comma
> docker run -it apache/airflow:2.1.2-python3.6 version
2.1.2
+Signal propagation
+------------------
+
+Airflow uses ``dumb-init`` to run as "init" in the entrypoint. This is in
order to propagate
+signals and reap child processes properly. This means that the process that
you run, does not have
+to install signal handlers to work properly and be killed when the container
is gracefully terminated.
+The behaviour of signal propagation is configured by ``DUMB_INIT_SETSID``
variable which is set to
+``1`` by default - meaning that the signals will be propagated to the whole
process group, but you can
+set it to ``0`` to enable ``single-child`` behaviour of ``dumb-init`` which
only propagates the
+signals to only single child process.
+
+
++------------------+-----------------------------------------------------------------------------------------------+
+| DUMB_INIT_SETSID | Use case
|
++------------------+-----------------------------------------------------------------------------------------------+
+| 1 (default) | If you run your processes as ``["bash", "-c"]`` command,
and bash spawn some new processes, |
Review comment:
Right!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]