hazza/docker-stacks
1
0
Fork 0
mirror of https://github.com/jupyter/docker-stacks.git synced 2025-10-08 18:44:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Unify base image choice

Browse Source
This commit is contained in:
Ayaz Salikhov
2023-07-28 13:18:07 +04:00
parent 4ee1da08c1
commit d3ffd76092
1 changed files with 7 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/using/recipes.md
View File

@@ -29,7 +29,6 @@ Create a new Dockerfile like the one shown below.
To use a requirements.txt file, first, create your `requirements.txt` file with the listing of packages desired. To use a requirements.txt file, first, create your `requirements.txt` file with the listing of packages desired.
```dockerfile ```dockerfile
# Start from a core stack version
FROM jupyter/base-notebook FROM jupyter/base-notebook
RUN mamba install --yes 'flake8' && \ RUN mamba install --yes 'flake8' && \
@@ -48,7 +47,6 @@ RUN mamba install --yes --file /tmp/requirements.txt && \
`pip` usage is similar: `pip` usage is similar:
```dockerfile ```dockerfile
# Start from a core stack version
FROM jupyter/base-notebook FROM jupyter/base-notebook
# Install in the default python3 environment # Install in the default python3 environment
@@ -75,7 +73,6 @@ The default version of Python that ships with the image may not be the version y
The instructions below permit adding a conda environment with a different Python version and making it accessible to Jupyter. The instructions below permit adding a conda environment with a different Python version and making it accessible to Jupyter.
```dockerfile ```dockerfile
# Choose your desired base image
FROM jupyter/minimal-notebook FROM jupyter/minimal-notebook
# name your environment and choose the python version # name your environment and choose the python version
@@ -112,7 +109,6 @@ RUN "${CONDA_DIR}/envs/${conda_env}/bin/python" -m ipykernel install --user --na
Create the Dockerfile as: Create the Dockerfile as:
```dockerfile ```dockerfile
# Start from a core stack version
FROM jupyter/scipy-notebook FROM jupyter/scipy-notebook
# Install the Dask dashboard # Install the Dask dashboard
@@ -215,9 +211,7 @@ Most containers, including our Ubuntu base image, ship without manpages installe
You can use the following Dockerfile to inherit from one of our images to enable manpages: You can use the following Dockerfile to inherit from one of our images to enable manpages:
```dockerfile ```dockerfile
# Choose your desired base image FROM jupyter/datascience-notebookR
ARG BASE_CONTAINER=jupyter/datascience-notebook
FROM $BASE_CONTAINER
USER root USER root
@@ -281,7 +275,8 @@ To use a specific version of JupyterHub, the version of `jupyterhub` in your ima
version in the Hub itself. version in the Hub itself.
```dockerfile ```dockerfile
FROM jupyter/base-notebook:2023-07-25 FROM jupyter/base-notebook
RUN pip install --no-cache-dir jupyterhub==1.4.1 && \ RUN pip install --no-cache-dir jupyterhub==1.4.1 && \
fix-permissions "${CONDA_DIR}" && \ fix-permissions "${CONDA_DIR}" && \
fix-permissions "/home/${NB_USER}" fix-permissions "/home/${NB_USER}"
@@ -472,7 +467,7 @@ For JupyterLab:
```bash ```bash
docker run -it --rm \ docker run -it --rm \
jupyter/base-notebook:2023-07-25 \ jupyter/base-notebook \
start-notebook.sh --IdentityProvider.token='' start-notebook.sh --IdentityProvider.token=''
``` ```
@@ -481,7 +476,7 @@ For Jupyter Notebook:
```bash ```bash
docker run -it --rm \ docker run -it --rm \
-e DOCKER_STACKS_JUPYTER_CMD=notebook \ -e DOCKER_STACKS_JUPYTER_CMD=notebook \
jupyter/base-notebook:2023-07-25 \ jupyter/base-notebook \
start-notebook.sh --IdentityProvider.token='' start-notebook.sh --IdentityProvider.token=''
``` ```
@@ -490,7 +485,6 @@ docker run -it --rm \
NB: this works for classic notebooks only NB: this works for classic notebooks only
```dockerfile ```dockerfile
# Update with your base image of choice
FROM jupyter/minimal-notebook FROM jupyter/minimal-notebook
USER ${NB_UID} USER ${NB_UID}
@@ -573,8 +567,7 @@ docker run -it --rm \
The example below is a Dockerfile to install the [ijavascript kernel](https://github.com/n-riesco/ijavascript). The example below is a Dockerfile to install the [ijavascript kernel](https://github.com/n-riesco/ijavascript).
```dockerfile ```dockerfile
# use one of the Jupyter Docker Stacks images FROM jupyter/scipy-notebook
FROM jupyter/scipy-notebook:2023-07-25
# install ijavascript # install ijavascript
RUN npm install -g ijavascript RUN npm install -g ijavascript
@@ -586,9 +579,7 @@ RUN ijsinstall
The following recipe demonstrates how to add functionality to read from and write to an instance of Microsoft SQL server in your notebook. The following recipe demonstrates how to add functionality to read from and write to an instance of Microsoft SQL server in your notebook.
```dockerfile ```dockerfile
ARG BASE_IMAGE=jupyter/base-notebook FROM jupyter/base-notebook
FROM $BASE_IMAGE
USER root USER root