diff --git a/README.md b/README.md index 1b437064..4c7d8406 100644 --- a/README.md +++ b/README.md @@ -26,11 +26,11 @@ The [User Guide on ReadTheDocs](https://jupyter-docker-stacks.readthedocs.io/en/ **Example 1:** -This command pulls the `jupyter/scipy-notebook` image tagged `0fd03d9356de` from Docker Hub if it is not already present on the local host. +This command pulls the `jupyter/scipy-notebook` image tagged `9e63909e0317` from Docker Hub if it is not already present on the local host. It then starts a container running a Jupyter Server and exposes the container's internal port `8888` to port `10000` of the host machine: ```bash -docker run -p 10000:8888 jupyter/scipy-notebook:0fd03d9356de +docker run -p 10000:8888 jupyter/scipy-notebook:9e63909e0317 ``` You can modify the port on which the container's port is exposed by [changing the value of the `-p` option](https://docs.docker.com/engine/reference/run/#expose-incoming-ports) to `-p 8888:8888`. @@ -45,11 +45,11 @@ The container remains intact for restart after the Jupyter Server exits. **Example 2:** -This command pulls the `jupyter/datascience-notebook` image tagged `0fd03d9356de` from Docker Hub if it is not already present on the local host. +This command pulls the `jupyter/datascience-notebook` image tagged `9e63909e0317` from Docker Hub if it is not already present on the local host. It then starts an _ephemeral_ container running a Jupyter Server and exposes the server on host port 10000. ```bash -docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work jupyter/datascience-notebook:0fd03d9356de +docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work jupyter/datascience-notebook:9e63909e0317 ``` The use of the `-v` flag in the command mounts the current working directory on the host (`${PWD}` in the example command) as `/home/jovyan/work` in the container. diff --git a/binder/Dockerfile b/binder/Dockerfile index 9d4a4bcd..7f0e35b3 100644 --- a/binder/Dockerfile +++ b/binder/Dockerfile @@ -3,7 +3,7 @@ # https://hub.docker.com/r/jupyter/base-notebook/tags ARG OWNER=jupyter -ARG BASE_CONTAINER=$OWNER/base-notebook:0fd03d9356de +ARG BASE_CONTAINER=$OWNER/base-notebook:9e63909e0317 FROM $BASE_CONTAINER LABEL maintainer="Jupyter Project " @@ -12,6 +12,6 @@ LABEL maintainer="Jupyter Project " # Fix: https://github.com/koalaman/shellcheck/wiki/SC3014 SHELL ["/bin/bash", "-o", "pipefail", "-c"] -ENV TAG="0fd03d9356de" +ENV TAG="9e63909e0317" COPY --chown=${NB_UID}:${NB_GID} binder/README.ipynb "${HOME}"/README.ipynb diff --git a/docs/using/recipes.md b/docs/using/recipes.md index 806edb2b..97ef4f76 100644 --- a/docs/using/recipes.md +++ b/docs/using/recipes.md @@ -29,7 +29,7 @@ Create a new Dockerfile like the one shown below. ```dockerfile # Start from a core stack version -FROM jupyter/datascience-notebook:0fd03d9356de +FROM jupyter/datascience-notebook:9e63909e0317 # Install in the default python3 environment RUN pip install --quiet --no-cache-dir 'flake8==3.9.2' && \ fix-permissions "${CONDA_DIR}" && \ @@ -48,7 +48,7 @@ Next, create a new Dockerfile like the one shown below. ```dockerfile # Start from a core stack version -FROM jupyter/datascience-notebook:0fd03d9356de +FROM jupyter/datascience-notebook:9e63909e0317 # Install from requirements.txt file COPY --chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ RUN pip install --quiet --no-cache-dir --requirement /tmp/requirements.txt && \ @@ -60,7 +60,7 @@ For conda, the Dockerfile is similar: ```dockerfile # Start from a core stack version -FROM jupyter/datascience-notebook:0fd03d9356de +FROM jupyter/datascience-notebook:9e63909e0317 # Install from requirements.txt file COPY --chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ RUN mamba install --yes --file /tmp/requirements.txt && \ @@ -283,7 +283,7 @@ To use a specific version of JupyterHub, the version of `jupyterhub` in your ima version in the Hub itself. ```dockerfile -FROM jupyter/base-notebook:0fd03d9356de +FROM jupyter/base-notebook:9e63909e0317 RUN pip install --quiet --no-cache-dir jupyterhub==1.4.1 && \ fix-permissions "${CONDA_DIR}" && \ fix-permissions "/home/${NB_USER}" @@ -474,7 +474,7 @@ For JupyterLab: ```bash docker run -it --rm \ - jupyter/base-notebook:0fd03d9356de \ + jupyter/base-notebook:9e63909e0317 \ start.sh jupyter lab --LabApp.token='' ``` @@ -482,7 +482,7 @@ For jupyter classic: ```bash docker run -it --rm \ - jupyter/base-notebook:0fd03d9356de \ + jupyter/base-notebook:9e63909e0317 \ start.sh jupyter notebook --NotebookApp.token='' ``` diff --git a/docs/using/running.md b/docs/using/running.md index cea4232a..1aeb6e01 100644 --- a/docs/using/running.md +++ b/docs/using/running.md @@ -15,12 +15,12 @@ The following are some common patterns. **Example 1:** -This command pulls the `jupyter/scipy-notebook` image tagged `0fd03d9356de` from Docker Hub if it is not already present on the local host. +This command pulls the `jupyter/scipy-notebook` image tagged `9e63909e0317` from Docker Hub if it is not already present on the local host. It then starts a container running a Jupyter Notebook server and exposes the server on host port 8888. The server logs appear in the terminal and include a URL to the notebook server. ```bash -docker run -it -p 8888:8888 jupyter/scipy-notebook:0fd03d9356de +docker run -it -p 8888:8888 jupyter/scipy-notebook:9e63909e0317 # Entered start.sh with args: jupyter lab @@ -39,7 +39,7 @@ Pressing `Ctrl-C` twice shuts down the notebook server but leaves the container # list containers docker ps -a # CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -# 221331c047c4 jupyter/scipy-notebook:0fd03d9356de "tini -g -- start-no…" 11 seconds ago Exited (0) 8 seconds ago cranky_benz +# 221331c047c4 jupyter/scipy-notebook:9e63909e0317 "tini -g -- start-no…" 11 seconds ago Exited (0) 8 seconds ago cranky_benz # start the stopped container docker start -a 221331c047c4 @@ -53,12 +53,12 @@ docker rm 221331c047c4 **Example 2:** -This command pulls the `jupyter/r-notebook` image tagged `0fd03d9356de` from Docker Hub if it is not already present on the local host. +This command pulls the `jupyter/r-notebook` image tagged `9e63909e0317` from Docker Hub if it is not already present on the local host. It then starts a container running a Jupyter Notebook server and exposes the server on host port 10000. The server logs appear in the terminal and include a URL to the notebook server, but with the internal container port (8888) instead of the correct host port (10000). ```bash -docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work jupyter/r-notebook:0fd03d9356de +docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work jupyter/r-notebook:9e63909e0317 ``` Pressing `Ctrl-C` twice shuts down the notebook server and immediately destroys the Docker container. @@ -130,7 +130,7 @@ subuidSize=$(( $(podman info --format "{{ range .Host.IDMappings.UIDMap }}+{{.Si subgidSize=$(( $(podman info --format "{{ range .Host.IDMappings.GIDMap }}+{{.Size }}{{end }}" ) - 1 )) ``` -This command pulls the `docker.io/jupyter/r-notebook` image tagged `0fd03d9356de` from Docker Hub if it is not already present on the local host. +This command pulls the `docker.io/jupyter/r-notebook` image tagged `9e63909e0317` from Docker Hub if it is not already present on the local host. It then starts a container running a Jupyter Server and exposes the server on host port 10000. The server logs appear in the terminal and include a URL to the notebook server, but with the internal container port (8888) instead of the correct host port (10000). @@ -139,7 +139,7 @@ podman run -it --rm -p 10000:8888 \ -v "${PWD}":/home/jovyan/work --user $uid:$gid \ --uidmap $uid:0:1 --uidmap 0:1:$uid --uidmap $(($uid+1)):$(($uid+1)):$(($subuidSize-$uid)) \ --gidmap $gid:0:1 --gidmap 0:1:$gid --gidmap $(($gid+1)):$(($gid+1)):$(($subgidSize-$gid)) \ - docker.io/jupyter/r-notebook:0fd03d9356de + docker.io/jupyter/r-notebook:9e63909e0317 ``` ```{warning} diff --git a/docs/using/selecting.md b/docs/using/selecting.md index eaa9ea10..5dafcd5f 100644 --- a/docs/using/selecting.md +++ b/docs/using/selecting.md @@ -201,7 +201,7 @@ Every Monday and whenever a pull request is merged, images are rebuilt and pushe Whenever a docker image is pushed to the container registry, it is tagged with: - a `latest` tag -- a 12-character git commit SHA like `0fd03d9356de` +- a 12-character git commit SHA like `9e63909e0317` - a date formatted like `2022-08-04` - OS version like `ubuntu-22.04` - a set of software version tags like `python-3.10.5` and `lab-3.4.4` diff --git a/examples/docker-compose/README.md b/examples/docker-compose/README.md index ce414867..8485de19 100644 --- a/examples/docker-compose/README.md +++ b/examples/docker-compose/README.md @@ -42,7 +42,7 @@ You can customize the docker-stack notebook image to deploy by modifying the `no For example, you can build and deploy a `jupyter/all-spark-notebook` by modifying the Dockerfile like so: ```dockerfile -FROM jupyter/all-spark-notebook:0fd03d9356de +FROM jupyter/all-spark-notebook:9e63909e0317 # Your RUN commands and so on ``` diff --git a/examples/docker-compose/notebook/Dockerfile b/examples/docker-compose/notebook/Dockerfile index 10870737..1d9d8c51 100644 --- a/examples/docker-compose/notebook/Dockerfile +++ b/examples/docker-compose/notebook/Dockerfile @@ -2,7 +2,7 @@ # Distributed under the terms of the Modified BSD License. # Pick your favorite docker-stacks image -FROM jupyter/minimal-notebook:0fd03d9356de +FROM jupyter/minimal-notebook:9e63909e0317 USER root diff --git a/examples/make-deploy/Dockerfile b/examples/make-deploy/Dockerfile index 10870737..1d9d8c51 100644 --- a/examples/make-deploy/Dockerfile +++ b/examples/make-deploy/Dockerfile @@ -2,7 +2,7 @@ # Distributed under the terms of the Modified BSD License. # Pick your favorite docker-stacks image -FROM jupyter/minimal-notebook:0fd03d9356de +FROM jupyter/minimal-notebook:9e63909e0317 USER root