Merge branch 'main' into freeze-version

Author: benz0li

CUDA.md

@@ -11,6 +11,8 @@ Images available for Python versions ≥ 3.11.1.
 https://demo.cuda.jupyter.b-data.ch.  
 :point_right: You can ask [b-data](mailto:request@b-data.ch?subject=[CUDA%20Jupyter]%20Request%20to%20whitelist%20GitHub%20account) to whitelist your GitHub account for access.
 
+![CUDA screenshot](assets/cuda-screenshot.png)
+
 **Build chain**
 
 The same as the
@@ -74,7 +76,7 @@ cd base && docker build \
   --build-arg BASE_IMAGE=ubuntu \
   --build-arg BASE_IMAGE_TAG=22.04 \
   --build-arg BUILD_ON_IMAGE=glcr.b-data.ch/cuda/python/ver \
-  --build-arg PYTHON_VERSION=3.11.5 \
+  --build-arg PYTHON_VERSION=3.12.0 \
   --build-arg CUDA_IMAGE_FLAVOR=devel \
   -t jupyterlab/cuda/python/base \
   -f latest.Dockerfile .
@@ -163,7 +165,29 @@ current value of `${NB_UID}` and `${NB_GID}`.
 
 The server logs appear in the terminal.
 
-**Using Docker Desktop**
+#### Using Podman (rootless mode, 3.11.6+)
+
+Create an empty home directory:
+
+```bash
+mkdir "${PWD}/jupyterlab-root"
+```
+
+Use the following command to run the container as `root`:
+
+```bash
+podman run -it --rm \
+  --device 'nvidia.com/gpu=all' \
+  -p 8888:8888 \
+  -u root \
+  -v "${PWD}/jupyterlab-root":/home/root \
+  -e NB_USER=root \
+  -e NB_UID=0 \
+  -e NB_GID=0 \
+  IMAGE[:MAJOR[.MINOR[.PATCH]]] start-notebook.sh --allow-root
+```
+
+#### Using Docker Desktop
 
 [Creating a home directory](#create-home-directory) *might* not be required.
 Also

CUDA_VERSION_MATRIX.md

@@ -4,6 +4,8 @@ Topmost entry = Tag `latest`
 
 | Python     | CUDA   | cuBLAS    | cuDNN | NCCL   | TensorRT  | Linux distro |
 |:-----------|:-------|:----------|:------|:-------|:----------|:-------------|
+| 3.12.0[^1] | 11.8.0 | 11.11.3.6 | 8.9.6 | 2.15.5 | 8.5.3[^2] | Ubuntu 22.04 |
+| 3.11.6     | 11.8.0 | 11.11.3.6 | 8.9.6 | 2.15.5 | 8.5.3[^2] | Ubuntu 22.04 |
 | 3.11.5     | 11.8.0 | 11.11.3.6 | 8.9.0 | 2.15.5 | 8.5.3[^2] | Ubuntu 22.04 |
 | 3.11.4     | 11.8.0 | 11.11.3.6 | 8.9.0 | 2.15.5 | 8.5.3[^2] | Ubuntu 22.04 |
 | 3.10.13    | 11.8.0 | 11.11.3.6 | 8.9.0 | 2.15.5 | 8.5.3[^2] | Ubuntu 22.04 |

NOTES.md

@@ -26,13 +26,16 @@ modified to
 
 The following startup hooks are put in place:
 
-* [/usr/local/bin/start-notebook.d/populate.sh](base/scripts/usr/local/bin/start-notebook.d/populate.sh)
+* [/usr/local/bin/start-notebook.d/10-populate.sh](base/scripts/usr/local/bin/start-notebook.d/10-populate.sh)
   to populate a *bind mounted* home directory `/home/jovyan`.
-* [/usr/local/bin/before-notebook.d/init.sh](base/scripts/usr/local/bin/before-notebook.d/init.sh) to
+* [/usr/local/bin/before-notebook.d/10-init.sh](base/scripts/usr/local/bin/before-notebook.d/10-init.sh) to
   * update timezone according to environment variable `TZ`.
   * add locales according to environment variable `LANGS`.
   * set locale according to environment variable `LANG`.
   * update code-server settings.
+* [/usr/local/bin/before-notebook.d/90-limits.sh](base/scripts/usr/local/bin/before-notebook.d/90-limits.sh)
+  to set the *soft limit* for *the maximum amount of virtual memory* based on
+  the amount of *physical* and *virtual memory* of the host.
 
 ### Custom scripts
 

README.md

@@ -14,6 +14,8 @@ Images considered stable for Python versions ≥ 3.10.5.
 
 :microscope: Check out `jupyterlab/python/scipy` at https://demo.jupyter.b-data.ch.
 
+![Screenshot](assets/screenshot.png)
+
 **Build chain**
 
 base → scipy
@@ -48,24 +50,34 @@ The following extensions are pre-installed for **code-server**:
   :information_source: devtools subtags
 * [Docker](https://open-vsx.org/extension/ms-azuretools/vscode-docker)  
   :information_source: docker subtags
+* [EditorConfig for VS Code](https://open-vsx.org/extension/EditorConfig/EditorConfig)
+  (3.11.3+)
 * [ESLint](https://open-vsx.org/extension/dbaeumer/vscode-eslint)  
   :information_source: devtools subtags
 * [Git Graph](https://open-vsx.org/extension/mhutchie/git-graph)
 * [GitHub Pull Requests and Issues](https://open-vsx.org/extension/GitHub/vscode-pull-request-github)
+  (3.11.5+)
 * [GitLab Workflow](https://open-vsx.org/extension/GitLab/gitlab-workflow)
 * [GitLens — Git supercharged](https://open-vsx.org/extension/eamodio/gitlens)  
   :information_source: Pinned to version 11.7.0 due to unsolicited AI content (3.11.4+)
 * [Excel Viewer](https://open-vsx.org/extension/GrapeCity/gc-excelviewer)
+* [hadolint](https://open-vsx.org/extension/exiasr/hadolint)  
+  :information_source: docker subtags (3.11.4+)
 * [Jupyter](https://open-vsx.org/extension/ms-toolsai/jupyter)
 * [LaTeX Workshop](https://open-vsx.org/extension/James-Yu/latex-workshop)  
   :information_source: scipy image
+* [markdownlint](https://open-vsx.org/extension/DavidAnson/vscode-markdownlint)
+  (3.11.6+)
 * [Path Intellisense](https://open-vsx.org/extension/christian-kohler/path-intellisense)
 * [Prettier - Code formatter](https://open-vsx.org/extension/esbenp/prettier-vscode)  
   :information_source: devtools subtags
 * [Project Manager](https://open-vsx.org/extension/alefragnani/project-manager)
 * [Python](https://open-vsx.org/extension/ms-python/python)
 * [Quarto](https://open-vsx.org/extension/quarto/quarto)  
   :information_source: scipy image
+* Resource Monitor (3.11.4+)
+* [ShellCheck](https://open-vsx.org/extension/timonwong/shellcheck)  
+  :information_source: devtools and docker subtags (3.11.4+)
 * [YAML](https://open-vsx.org/extension/redhat/vscode-yaml)
 
 **Subtags**
@@ -114,7 +126,7 @@ To install docker, follow the instructions for your platform:
 
 ```bash
 cd base && docker build \
-  --build-arg PYTHON_VERSION=3.11.5 \
+  --build-arg PYTHON_VERSION=3.12.0 \
   -t jupyterlab/python/base \
   -f latest.Dockerfile .
 ```
@@ -196,7 +208,7 @@ current value of `${NB_UID}` and `${NB_GID}`.
 
 The server logs appear in the terminal.
 
-#### Using Podman (rootless mode, 3.11.5+)
+#### Using Podman (rootless mode, 3.11.6+)
 
 Create an empty home directory:
 

VERSION_MATRIX.md

@@ -2,23 +2,25 @@
 
 Topmost entry = Tag `latest`
 
-| Python     | Jupyter Hub | Jupyter Lab | code‑server (Code) | Git    | Git LFS | Pandoc | Quarto[^2]  | CTAN date[^2] | Linux distro |
-|:-----------|:------------|:------------|:-------------------|:-------|:--------|:-------|:------------|:--------------|:-------------|
-| 3.11.5     | 4.0.2       | 3.6.6       | 4.17.1 (1.82.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 1.3.450     | 2023‑10‑02    | Debian 12    |
-| 3.11.4     | 4.0.2       | 3.6.5       | 4.16.1 (1.80.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 1.3.450     | 2023‑08‑24    | Debian 12    |
-| 3.10.13    | 4.0.2       | 3.6.5       | 4.16.1 (1.80.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 1.3.450     | 2023‑08‑24    | Debian 12    |
-| 3.11.3     | 4.0.0       | 3.6.4       | 4.13.0 (1.78.2)    | 2.41.0 | 3.3.0   | 3.1.1  | 1.3.361     | 2023‑06‑06    | Debian 11    |
-| 3.10.12    | 4.0.0       | 3.6.4       | 4.13.0 (1.78.2)    | 2.41.0 | 3.3.0   | 3.1.1  | 1.3.361     | 2023‑06‑06    | Debian 11    |
-| 3.11.2[^1] | 3.1.1       | 3.6.3       | 4.9.1 (1.73.1)     | 2.40.0 | 3.3.0   | 2.19.2 | 1.2.475[^3] | 2023‑04‑05    | Debian 11    |
-| 3.10.11    | 3.1.1       | 3.6.3       | 4.9.1 (1.73.1)     | 2.40.0 | 3.3.0   | 2.19.2 | 1.2.475[^3] | 2023‑04‑05    | Debian 11    |
-| 3.11.1[^1] | 3.1.1       | 3.5.3       | 4.9.1 (1.73.1)     | 2.39.1 | 3.3.0   | 2.19.2 | 1.2.335[^3] | 2023‑02‑08    | Debian 11    |
-| 3.10.10    | 3.1.1       | 3.5.3       | 4.9.1 (1.73.1)     | 2.39.1 | 3.3.0   | 2.19.2 | 1.2.335[^3] | 2023‑02‑08    | Debian 11    |
-| 3.11.0[^1] | 3.1.0       | 3.5.1       | 4.9.0 (1.73.1)     | 2.38.1 | 3.3.0   | 2.19.2 | 1.2.269[^3] | 2022‑12‑06    | Debian 11    |
-| 3.10.9     | 3.1.0       | 3.5.1       | 4.9.0 (1.73.1)     | 2.38.1 | 3.3.0   | 2.19.2 | 1.2.269[^3] | 2022‑12‑06    | Debian 11    |
-| 3.10.8     | 2.3.1       | 3.5.0       | 4.7.1 (1.71.2)     | 2.38.1 | 3.2.0   | 2.19.2 | 1.1.251[^3] | 2022‑10‑24    | Debian 11    |
-| 3.10.7     | 2.3.1       | 3.4.8       | 4.7.1 (1.71.2)     | 2.38.0 | 3.2.0   | 2.19.2 | 1.1.251[^3] | 2022‑10‑11    | Debian 11    |
-| 3.10.6     | 2.3.1       | 3.4.6       | 4.6.1 (1.70.2)     | 2.37.3 | 3.2.0   | 2.19.2 | 1.1.189[^3] | 2022‑09‑06    | Debian 11    |
-| 3.10.5     | 2.3.1       | 3.4.4       | 4.5.1 (1.68.1)     | 2.37.1 | 3.2.0   | 2.18   | 1.0.37[^3]  | 2022‑08‑02    | Debian 11    |
+| Python     | Jupyter Hub | Jupyter Lab | code‑server (Code) | Git    | Git LFS | Pandoc | CTAN date[^2] | Quarto[^2]  | Linux distro |
+|:-----------|:------------|:------------|:-------------------|:-------|:--------|:-------|:--------------|:------------|:-------------|
+| 3.12.0[^1] | 4.0.2       | 4.0.9       | 4.19.1 (1.84.2)    | 2.43.0 | 3.4.0   | 3.1.1  |               | 1.3.450     | Debian 12    |
+| 3.11.6     | 4.0.2       | 4.0.9       | 4.19.0 (1.84.2)    | 2.43.0 | 3.4.0   | 3.1.1  |               | 1.3.450     | Debian 12    |
+| 3.11.5     | 4.0.2       | 3.6.6       | 4.17.1 (1.82.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 2023‑10‑02    | 1.3.450     | Debian 12    |
+| 3.11.4     | 4.0.2       | 3.6.5       | 4.16.1 (1.80.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 2023‑08‑24    | 1.3.450     | Debian 12    |
+| 3.10.13    | 4.0.2       | 3.6.5       | 4.16.1 (1.80.2)    | 2.42.0 | 3.4.0   | 3.1.1  | 2023‑08‑24    | 1.3.450     | Debian 12    |
+| 3.11.3     | 4.0.0       | 3.6.4       | 4.13.0 (1.78.2)    | 2.41.0 | 3.3.0   | 3.1.1  | 2023‑06‑06    | 1.3.361     | Debian 11    |
+| 3.10.12    | 4.0.0       | 3.6.4       | 4.13.0 (1.78.2)    | 2.41.0 | 3.3.0   | 3.1.1  | 2023‑06‑06    | 1.3.361     | Debian 11    |
+| 3.11.2[^1] | 3.1.1       | 3.6.3       | 4.9.1 (1.73.1)     | 2.40.0 | 3.3.0   | 2.19.2 | 2023‑04‑05    | 1.2.475[^3] | Debian 11    |
+| 3.10.11    | 3.1.1       | 3.6.3       | 4.9.1 (1.73.1)     | 2.40.0 | 3.3.0   | 2.19.2 | 2023‑04‑05    | 1.2.475[^3] | Debian 11    |
+| 3.11.1[^1] | 3.1.1       | 3.5.3       | 4.9.1 (1.73.1)     | 2.39.1 | 3.3.0   | 2.19.2 | 2023‑02‑08    | 1.2.335[^3] | Debian 11    |
+| 3.10.10    | 3.1.1       | 3.5.3       | 4.9.1 (1.73.1)     | 2.39.1 | 3.3.0   | 2.19.2 | 2023‑02‑08    | 1.2.335[^3] | Debian 11    |
+| 3.11.0[^1] | 3.1.0       | 3.5.1       | 4.9.0 (1.73.1)     | 2.38.1 | 3.3.0   | 2.19.2 | 2022‑12‑06    | 1.2.269[^3] | Debian 11    |
+| 3.10.9     | 3.1.0       | 3.5.1       | 4.9.0 (1.73.1)     | 2.38.1 | 3.3.0   | 2.19.2 | 2022‑12‑06    | 1.2.269[^3] | Debian 11    |
+| 3.10.8     | 2.3.1       | 3.5.0       | 4.7.1 (1.71.2)     | 2.38.1 | 3.2.0   | 2.19.2 | 2022‑10‑24    | 1.1.251[^3] | Debian 11    |
+| 3.10.7     | 2.3.1       | 3.4.8       | 4.7.1 (1.71.2)     | 2.38.0 | 3.2.0   | 2.19.2 | 2022‑10‑11    | 1.1.251[^3] | Debian 11    |
+| 3.10.6     | 2.3.1       | 3.4.6       | 4.6.1 (1.70.2)     | 2.37.3 | 3.2.0   | 2.19.2 | 2022‑09‑06    | 1.1.189[^3] | Debian 11    |
+| 3.10.5     | 2.3.1       | 3.4.4       | 4.5.1 (1.68.1)     | 2.37.1 | 3.2.0   | 2.18   | 2022‑08‑02    | 1.0.37[^3]  |Debian 11    |
 
 [^1]: w/o numba
 [^2]: scipy image