summaryrefslogtreecommitdiff
path: root/topics/notebooks/user-stories.gmi
diff options
context:
space:
mode:
authorPjotr Prins2024-02-25 09:49:12 +0100
committerPjotr Prins2024-02-27 14:29:27 +0100
commit3100a094e5a97e0b00709886e861ace6f164a1dd (patch)
tree706b7da15cde3d17c659e041149b1dd9393e262f /topics/notebooks/user-stories.gmi
parent5e6f5ef6e1ebe9ce4fed8030524227b975e025ad (diff)
downloadgn-gemtext-3100a094e5a97e0b00709886e861ace6f164a1dd.tar.gz
Remove docs without info
Diffstat (limited to 'topics/notebooks/user-stories.gmi')
-rw-r--r--topics/notebooks/user-stories.gmi126
1 files changed, 0 insertions, 126 deletions
diff --git a/topics/notebooks/user-stories.gmi b/topics/notebooks/user-stories.gmi
deleted file mode 100644
index 013ee48..0000000
--- a/topics/notebooks/user-stories.gmi
+++ /dev/null
@@ -1,126 +0,0 @@
-# Next Steps
-
-## Tags
-
-* assigned: jgart
-* type: enhancement
-* keywords: notebooks, jupyter
-* status: unclear
-
-## Description
-Whenever we start a notebook let's generate an id (put the id in a db or in memory start) and then accept the id as
-part of the route to get to the notebook.
-
-The server has to look that id up and route the user to that particular jupyter notebook instance.
-
-Currently, users are directed to a jupyter notebook instance via parsing the output of `list_running_servers`:
-
-=> https://git.genenetwork.org/jgart/binderlite/src/branch/master/app.py#L37 list_running_servers in binderlite src
-
-This has its issues because we cannot uniquely identify the last launched notebook.
-
-## Optimizations
-
-### Shutdown notebook and save to memory
-
-If we are shutting down the notebook to save memory then we want
-to remember it's location in order to return to it.
-
-The jupyter notebook API has a function for listing currently running notebooks (mentioned above):
-
-```
-def list_running_servers(runtime_dir=None):
- """Iterate over the server info files of running notebook servers.
-
- Given a runtime directory, find nbserver-* files in the security directory,
- and yield dicts of their information, each one pertaining to
- a currently running notebook server instance.
- """
-```
-
-There is also a function for getting a timestamp of the last time the notebook server did something:
-
-```
- def last_activity(self):
- """Get a UTC timestamp for when the server last did something.
-
- Includes: API activity, kernel activity, kernel shutdown, and terminal
- activity.
- """
-```
-
-I need to decide on a way to uniquely identify the last built jupyter notebook.
-
-### Shutdown kernels gracefully
-
-* shutdown jupyter gracefully
-
-Find a way to shutdown jupyter kernels gracefully. Jupyter kernels are currently shutdown by sending a kill signal
-(SIGINT, Ctrl+c) via the terminal.
-
-This currently produces the following error:
-
-```
-Exception in thread Thread-1:
-Traceback (most recent call last):
- File "/gnu/store/sd2ic7bpv8fx3imy1j8xcjclx71sv6q0-python-3.8.2/lib/python3.8/threading.py", line 932, in _bootstrap_inner
- self.run()
- File "/gnu/store/sd2ic7bpv8fx3imy1j8xcjclx71sv6q0-python-3.8.2/lib/python3.8/threading.py", line 870, in run
- self._target(*self._args, **self._kwargs)
- File "/gnu/store/w9bgs701xg1gbhxb6a4fsrjkj10c4sxc-python-notebook-6.3.0/lib/python3.8/site-packages/notebook/notebookapp.py", line 1961, in _confirm_exit
- line = sys.stdin.readline()
- OSError: [Errno 5] Input/output error
-```
-
-## guix-kernel runs by default in a container
-
-guix-kernel (AKA guix-jupyter) runs by default in a container.
-
-See here:
-
-=> https://gitlab.inria.fr/guix-hpc/guix-kernel/-/blob/master/guix/jupyter/kernel.scm#L181 eval/container*
-
-The reason I bring this up is because I currently run binderlite without the `--container` flag.
-
-If I try to run it with the `--container` flag then I run into permission issues due to running a container
-
-inside another container.
-
-## Question(s)
-
-###
-
-What is the idiomatic way in nginx to forward everything beyond some prefix.
-
-Currently using the $rest arg but that might not be a good way to do it:
-
-=> https://git.genenetwork.org/jgart/binderlite/src/branch/master/nginx.conf#L36
-
-###
-
-Do we want to avoid hard coding guix-kernel to run inside a container and instead be able to explicitly
-specify a container environment from the binderlite app or should this be left to guix-kernel?
-
-See above section on guix-kernel running by default in a container.
-
-Suggestion: we will create our own derived kernels and dependencies.
-
-###
-
-I currently cannot kill running jupyter instances on penguin2:
-
-```
-kill-jupyter
-kill: (1251): Operation not permitted
-kill: (34495): No such process
-kill: (52689): Operation not permitted
-kill: (52720): Operation not permitted
-kill: (52956): Operation not permitted
-Killed
-```
-
-=> https://git.genenetwork.org/jgart/binderlite/src/branch/master/bin/kill-jupyter kill-jupyter
-
-How should I get around this?
-
-Suggestion: try killing a container rather then the jupyter process. Use the pid of the container.