Name: docker-stacks
Owner: Project Jupyter
Description: Opinionated stacks of ready-to-run Jupyter applications in Docker.
Created: 2015-07-15 15:30:00.0
Updated: 2018-01-17 14:04:03.0
Pushed: 2018-01-15 04:20:32.0
Size: 952
Language: Jupyter Notebook
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Opinionated stacks of ready-to-run Jupyter applications in Docker.
If you're familiar with Docker, have it configured, and know exactly what you'd like to run, one of these commands should get you up and running:
n an ephemeral Jupyter Notebook server in a Docker container in the terminal foreground.
te that any work saved in the container will be lost when it is destroyed with this config.
i: pseudo-TTY+STDIN open.
m: remove the container on exit.
: publish port to the host
er run -ti --rm -p 8888:8888 jupyter/<your desired stack>:<git-sha-tag>
n a Jupyter Notebook server in a Docker container in the terminal foreground.
y files written to ~/work in the container will be saved to the current working
rectory on the host.
er run -ti --rm -p 8888:8888 -v "$PWD":/home/jovyan/work jupyter/<your desired stack>:<git-sha-tag>
n an ephemeral Jupyter Notebook server in a Docker container in the background.
te that any work saved in the container will be lost when it is destroyed with this config.
: detach, run container in background.
: Publish all exposed ports to random ports
er run -d -P jupyter/<your desired stack>:<git-sha-tag>
If this is your first time using Docker or any of the Jupyter projects, do the following to get started.
Here's a diagram of the FROM
relationships between all of the images defined in this project:
Click here for a commented build history of each image, with references to tag/SHA values.
The following are quick-links to READMEs about each image and their Docker image tags on Docker Cloud:
Starting with git commit SHA 9bd33dcc8688:
jupyter/<stack name>
on Docker Hub (e.g., all-spark-notebook → jupyter/all-spark-notebook).latest
tag in each Docker Hub repository tracks the master
branch HEAD
reference on GitHub.
This is a moving target and will make backward-incompatible changes regularly.latest
.3.2
and 4.0
on Docker Hub which point to images prior to our versioning scheme switch.FROM jupyter/scipy-notebook:7c45ec67c8e7
.
latest
is a moving target which can change in backward-incompatible ways as packages and operating systems are updated.cc9feab481f7
. If you wish to continue using Python 2.x, pin to tag 82b978b3ceeb
.tini -- start-notebook.sh
is the default Docker entrypoint-plus-command in every notebook stack. If you plan to modify it in any way, be sure to check the Notebook Options section of your stack's README to understand the consequences.To build new images on Docker Cloud and publish them to the Docker Hub registry, do the following:
When there's a security fix in the Ubuntu base image, do the following in place of the last command:
Update the ubuntu:16.04
SHA in the most-base images (e.g., base-notebook). Submit it as a regular PR and go through the build process. Expect the build to take a while to complete: every image layer will rebuild.
When there's a new stack definition, do the following before merging the PR with the new stack:
jupyter
org on Docker Cloud named after the stack folder in the git repo.stacks
team permission to write to the repo.jupyter/docker-stacks
as the source repository./<name-of-the-stack>
.jupyter/base-notebook
).When there's a new maintainer, do the following:
If automated builds have got you down, do the following:
docker login
with your Docker Hub/Cloud credentials.make retry/release-all
.When make retry/release-all
successfully pushes the last of its images to Docker Hub (currently jupyter/all-spark-notebook
), Docker Hub invokes the webhook which updates the Docker build history wiki page.