Skip to content

Commit

Permalink
Update tag example
Browse files Browse the repository at this point in the history
  • Loading branch information
mathbunnyru committed May 5, 2024
1 parent feeb4e7 commit 44a1954
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 14 deletions.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,11 @@ Older images are available on Docker Hub, but they will no longer be updated.

### Example 1

This command pulls the `jupyter/scipy-notebook` image tagged `2024-03-14` from Quay.io if it is not already present on the local host.
This command pulls the `jupyter/scipy-notebook` image tagged `2024-04-29` from Quay.io if it is not already present on the local host.
It then starts a container running a Jupyter Server with the JupyterLab frontend and exposes the container's internal port `8888` to port `10000` of the host machine:

```bash
docker run -p 10000:8888 quay.io/jupyter/scipy-notebook:2024-03-14
docker run -p 10000:8888 quay.io/jupyter/scipy-notebook:2024-04-29
```

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/#exposed-ports) to `-p 8888:8888`.
Expand All @@ -49,11 +49,11 @@ The container remains intact for restart after the Server exits.

### Example 2

This command pulls the `jupyter/datascience-notebook` image tagged `2024-03-14` from Quay.io if it is not already present on the local host.
This command pulls the `jupyter/datascience-notebook` image tagged `2024-04-29` from Quay.io if it is not already present on the local host.
It then starts an _ephemeral_ container running a Jupyter Server with the JupyterLab frontend and exposes the server on host port 10000.

```bash
docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work quay.io/jupyter/datascience-notebook:2024-03-14
docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work quay.io/jupyter/datascience-notebook:2024-04-29
```

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.
Expand Down Expand Up @@ -101,7 +101,7 @@ more information is available in the [documentation](https://jupyter-docker-stac
- Single-platform images have either `aarch64-` or `x86_64-` tag prefixes, for example, `quay.io/jupyter/base-notebook:aarch64-python-3.11.6`
- Starting from `2022-09-21`, we create multi-platform images (except `tensorflow-notebook`)
- Starting from `2023-06-01`, we create a multi-platform `tensorflow-notebook` image as well
- Starting from `2024-03-14`, we create CUDA enabled variant of `pytorch-notebook` image for `x86_64` platform
- Starting from `2024-04-29`, we create CUDA enabled variant of `pytorch-notebook` image for `x86_64` platform

## Using old images

Expand Down
4 changes: 2 additions & 2 deletions binder/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
# https://quay.io/repository/jupyter/base-notebook?tab=tags
ARG REGISTRY=quay.io
ARG OWNER=jupyter
ARG BASE_CONTAINER=$REGISTRY/$OWNER/base-notebook:2024-03-14
ARG BASE_CONTAINER=$REGISTRY/$OWNER/base-notebook:2024-04-29
FROM $BASE_CONTAINER

LABEL maintainer="Jupyter Project <jupyter@googlegroups.com>"
Expand All @@ -13,6 +13,6 @@ LABEL maintainer="Jupyter Project <jupyter@googlegroups.com>"
# Fix: https://github.com/koalaman/shellcheck/wiki/SC3014
SHELL ["/bin/bash", "-o", "pipefail", "-c"]

ENV TAG="2024-03-14"
ENV TAG="2024-04-29"

COPY --chown=${NB_UID}:${NB_GID} binder/README.ipynb "${HOME}"/README.ipynb
14 changes: 7 additions & 7 deletions docs/using/running.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,12 @@ The following are some common patterns.

### Example 1

This command pulls the `jupyter/scipy-notebook` image tagged `2024-03-14` from Quay.io if it is not already present on the local host.
This command pulls the `jupyter/scipy-notebook` image tagged `2024-04-29` from Quay.io if it is not already present on the local host.
It then starts a container running Jupyter Server with the JupyterLab frontend and exposes the server on host port 8888.
The server logs appear in the terminal and include a URL to the server.

```bash
docker run -it -p 8888:8888 quay.io/jupyter/scipy-notebook:2024-03-14
docker run -it -p 8888:8888 quay.io/jupyter/scipy-notebook:2024-04-29

# Entered start.sh with args: jupyter lab

Expand All @@ -39,7 +39,7 @@ Pressing `Ctrl-C` twice shuts down the Server but leaves the container intact on
# list containers
docker ps --all
# CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
# eca4aa01751c quay.io/jupyter/scipy-notebook:2024-03-14 "tini -g -- start-no…" About a minute ago Exited (0) 5 seconds ago silly_panini
# eca4aa01751c quay.io/jupyter/scipy-notebook:2024-04-29 "tini -g -- start-no…" About a minute ago Exited (0) 5 seconds ago silly_panini

# start the stopped container
docker start --attach -i eca4aa01751c
Expand All @@ -53,12 +53,12 @@ docker rm eca4aa01751c

### Example 2

This command pulls the `jupyter/r-notebook` image tagged `2024-03-14` from Quay.io if it is not already present on the local host.
This command pulls the `jupyter/r-notebook` image tagged `2024-04-29` from Quay.io if it is not already present on the local host.
It then starts a container running Server and exposes the server on host port 10000.
The server logs appear in the terminal and include a URL to the 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 quay.io/jupyter/r-notebook:2024-03-14
docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work quay.io/jupyter/r-notebook:2024-04-29
```

Pressing `Ctrl-C` twice shuts down the Server and immediately destroys the Docker container.
Expand Down Expand Up @@ -138,7 +138,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 `quay.io/jupyter/r-notebook` image tagged `2024-03-14` from Quay.io if it is not already present on the local host.
This command pulls the `quay.io/jupyter/r-notebook` image tagged `2024-04-29` from Quay.io if it is not already present on the local host.
It then starts a container running a Jupyter Server with the JupyterLab frontend and exposes the server on host port 10000.
The server logs appear in the terminal and include a URL to the server but with the internal container port (8888) instead of the correct host port (10000).

Expand All @@ -147,7 +147,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)) \
quay.io/jupyter/r-notebook:2024-03-14
quay.io/jupyter/r-notebook:2024-04-29
```

```{warning}
Expand Down

0 comments on commit 44a1954

Please sign in to comment.