Skip to content

Commit 2827e5f

Browse files
committed
documentation update on postStart hook use
1 parent fc323db commit 2827e5f

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

docs/source/jupyterhub/customizing/user-environment.md

+6
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,12 @@ container, meaning that commands that place files relative to `./` will result
331331
in users seeing those files in their home directory. You can use commands like
332332
`wget` to place files where you like.
333333

334+
It's also worth mentioning that Kubernetes PostStart hook is
335+
[executed asynchronously](https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#hook-handler-execution).
336+
This means there is no guarantee that the hook will execute before the container
337+
ENTRYPOINT. This makes postStart hook unusable if some initialization must complete
338+
before the user server start. For these cases a [custom command](#set-cmd) may be used.
339+
334340
A simple way to populate the notebook user's home directory is to add the
335341
required files to the container's `/tmp` directory and then copy them to
336342
`/home/jovyan` using a `postStart` hook. This example shows the use of

0 commit comments

Comments
 (0)