diff --git a/README.md b/README.md index d1f17ab..4fbd930 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,5 @@ This repository contains Jupyter docker images developed by the [nbgallery](http * [nbgallery/base-notebook](base-notebook): This is the base image that we use in production deployments with the [nbgallery](https://github.com/nbgallery/nbgallery) notebook collaboration platform. It is built on top of Project Jupyter's official [jupyter/base-notebook](https://github.com/jupyter/docker-stacks/tree/master/base-notebook) and is available at [Docker Hub](https://hub.docker.com/r/nbgallery/base-notebook). The image contains Jupyter [extensions](https://github.com/nbgallery/nbgallery-extensions) to [integrate](https://github.com/nbgallery/nbgallery/blob/master/docs/jupyter_integration.md) with the nbgallery. * Experimental additions to `nbgallery/base-notebook` - these are not actively maintained, but contain Dockerfiles to add features that you may be interested in: - * [vscode](vscode): Adds vscode server within Jupyter * [PDF via LaTeX](pdf-latex): Adds support for notebook-to-PDF conversion via LaTeX * [PDF via HTML](pdf-html): Adds support for notebook-to-PDF conversion via HTML using Chromium - * [nbgallery/alpine-notebook](alpine-notebook): A simple Jupyter image built on Alpine Linux, *without* nbgallery integration. This image is about half the size of `jupyter/base-notebook`. We've [moved off of Alpine](https://github.com/nbgallery/jupyter-alpine#repository-status) but thought it might be useful to the community to capture some of our experience using Jupyter on Alpine in production. diff --git a/alpine-notebook/Dockerfile b/alpine-notebook/Dockerfile deleted file mode 100644 index 48eb79d..0000000 --- a/alpine-notebook/Dockerfile +++ /dev/null @@ -1,28 +0,0 @@ -FROM alpine:3.10 - -LABEL maintainer="https://github.com/nbgallery" - -USER root - -RUN \ - apk --update add \ - bash \ - build-base \ - bzip2 \ - ca-certificates \ - curl \ - openssh-client \ - patch \ - python3-dev \ - py3-zmq \ - readline-dev \ - tar \ - tini \ - wget && \ - rm -rf /var/cache/apk/* && \ - pip3 install --no-cache-dir notebook && \ - mkdir /notebooks - -ENTRYPOINT ["/sbin/tini", "--"] -CMD ["jupyter", "notebook", "--allow-root", "--port=8888", "--ip='*'", "--no-browser", "--notebook-dir=/notebooks"] - diff --git a/alpine-notebook/README.md b/alpine-notebook/README.md deleted file mode 100644 index 198cacb..0000000 --- a/alpine-notebook/README.md +++ /dev/null @@ -1,18 +0,0 @@ -# Alpine Linux Jupyter image - -[![Project Status: Inactive – The project has reached a stable, usable state but is no longer being actively developed; support/maintenance will be provided as time allows.](https://www.repostatus.org/badges/latest/inactive.svg)](https://www.repostatus.org/#inactive) - -This is a simple no-frills Jupyter image built on Alpine Linux; it is available at [Docker Hub](https://hub.docker.com/r/nbgallery/alpine-notebook). It is about half the size of Project Jupyter's smallest image, [`jupyter/base-notebook`](https://github.com/jupyter/docker-stacks/tree/master/base-notebook), but also lacks a lot of the features in the that image. PyPI does not have Alpine-compatible binaries, so we've added the [build-base package](https://pkgs.alpinelinux.org/package/v3.10/main/x86_64/build-base) so native extensions can be compiled (`jupyter/base-notebook` does not include gcc/g++). - -[We no longer use Alpine ourselves](https://github.com/nbgallery/jupyter-alpine#repository-status), but we'll try to keep this updated as new versions of Alpine are released. *Note that in contrast with our [old image](https://github.com/nbgallery/jupyter-alpine) and other images in this repository, `alpine-notebook` does not contain any nbgallery integration.* - -Some variations that might be worth trying: - - * Including `build-base` does add a fair amount of size (relatively speaking) to the image. If you need to go even smaller, you could remove it and rely on some of the pre-compiled packages in the Alpine repo (e.g. [py3-numpy](https://pkgs.alpinelinux.org/package/v3.10/community/x86_64/py3-numpy)). Pip doesn't know about these packages, so you would need to either bake them into your docker image or use our package [ipydeps](https://pypi.org/project/ipydeps/). Ipydeps [can be configured](https://github.com/nbgallery/ipydeps#dependenciesjson) to override pip installs with arbitrary commands to install the package differently -- here is our [old config file](https://github.com/nbgallery/nbgallery/blob/master/public/integration/alpine-py-dependencies.json) (no longer maintained; see also [min-apk-safe](https://github.com/nbgallery/jupyter-alpine/blob/master/util/min-apk-safe) referenced within). - * Project Jupyter's docker images include Conda, but this image does not. However, you could try building a conda-based Jupyter image on top of [this Alpine miniconda image](https://github.com/frol/docker-alpine-miniconda3). That would potentially give you something more similar to the official images. - -Other related projects: - - * [Minimal Dockerfiles for Binder](https://github.com/binder-examples/minimal-dockerfile) - * Alpine-based [minimal image for Binder](https://github.com/minrk/smallest-binder) - * [Minimal Debian-based image with scientific stack](https://github.com/gitjeff05/jupyterlab-minimalist-image)