diff --git a/src/main/resources/org/jenkinsci/plugins/workflow/steps/durable_task/ShellStep/help-script.html b/src/main/resources/org/jenkinsci/plugins/workflow/steps/durable_task/ShellStep/help-script.html index 908c2653..9649e8ac 100644 --- a/src/main/resources/org/jenkinsci/plugins/workflow/steps/durable_task/ShellStep/help-script.html +++ b/src/main/resources/org/jenkinsci/plugins/workflow/steps/durable_task/ShellStep/help-script.html @@ -9,4 +9,16 @@ Otherwise the system default shell will be run, using the -xe flags (you can specify set +e and/or set +x to disable those).

+

+ NOTE: Depending on the underlying OS, the script is launched and monitored using a binary (for *NIX) with the + prefix durable-task-monitor- or a shell wrapper (all other environments). + Because the binary/shell wrapper is launched as a background process, please ensure that the target script + environment is able to reap orphaned processes (i.e. zombie-reaping). For example, in Docker, you may use the + --init flag, + while in Kubernetes, you may leverage + shared process namespace. + With shared process namespaces, the pod sandbox will be assigned PID 1 and assume zombie-reaping responsibilities. + To force durable-task to always use the shell wrapper, pass the system property + `org.jenkinsci.plugins.durabletask.BourneShellScript.FORCE_SHELL_WRAPPER=true` to the Java command line used to start Jenkins. +

\ No newline at end of file