mirror of
https://github.com/jupyter/docker-stacks.git
synced 2025-10-15 05:52:57 +00:00
Update docs to better reflect current state
This commit is contained in:
Ayaz Salikhov
@@ -31,6 +31,7 @@ and versioning strategy.
|
||||
- [Miniforge](https://github.com/conda-forge/miniforge) Python 3.x in `/opt/conda` with two package managers
|
||||
- [conda](https://github.com/conda/conda): "cross-platform, language-agnostic binary package manager".
|
||||
- [mamba](https://github.com/mamba-org/mamba): "reimplementation of the conda package manager in C++".
|
||||
- `notebook`, `jupyterhub` and `jupyterlab` packages
|
||||
- No preinstalled scientific computing packages
|
||||
- Unprivileged user `jovyan` (`uid=1000`, configurable, see options) in group `users` (`gid=100`)
|
||||
with ownership over the `/home/jovyan` and `/opt/conda` paths
|
||||
@@ -52,7 +53,7 @@ and versioning strategy.
|
||||
- [TeX Live](https://www.tug.org/texlive/) for notebook document conversion
|
||||
- [git](https://git-scm.com/),
|
||||
[vi](https://www.vim.org) (actually `vim-tiny`),
|
||||
[nano](https://www.nano-editor.org/) (actually `nano-tiny`), tzdata, and unzip
|
||||
[nano](https://www.nano-editor.org/) (actually `nano-tiny`), `tzdata`, and `unzip`
|
||||
|
||||
### jupyter/r-notebook
|
||||
|
||||
@@ -65,17 +66,25 @@ and versioning strategy.
|
||||
- Everything in `jupyter/minimal-notebook` and its ancestor images
|
||||
- The [R](https://www.r-project.org/) interpreter and base environment
|
||||
- [IRKernel](https://irkernel.github.io/) to support R code in Jupyter notebooks
|
||||
- [tidyverse](https://www.tidyverse.org/) packages from
|
||||
[conda-forge](https://conda-forge.org/feedstock-outputs/index.html)
|
||||
- [devtools](https://cran.r-project.org/web/packages/devtools/index.html),
|
||||
[shiny](https://shiny.rstudio.com/), [rmarkdown](https://rmarkdown.rstudio.com),
|
||||
[forecast](https://cran.r-project.org/web/packages/forecast/forecast.pdf),
|
||||
[rsqlite](https://cran.r-project.org/web/packages/RSQLite/index.html),
|
||||
- [tidyverse](https://www.tidyverse.org/)
|
||||
packages from [conda-forge](https://conda-forge.org/feedstock-outputs/index.html)
|
||||
- [caret](https://topepo.github.io/caret/index.html),
|
||||
[crayon](https://cran.r-project.org/web/packages/crayon/index.html),
|
||||
[devtools](https://cran.r-project.org/web/packages/devtools/index.html),
|
||||
[forecast](https://cran.r-project.org/web/packages/forecast/index.html),
|
||||
[hexbin](https://cran.r-project.org/web/packages/hexbin/index.html),
|
||||
[htmltools](https://cran.r-project.org/web/packages/htmltools/index.html),
|
||||
[htmlwidgets](https://www.htmlwidgets.org),
|
||||
[nycflights13](https://cran.r-project.org/web/packages/nycflights13/index.html),
|
||||
[caret](https://topepo.github.io/caret/index.html), [tidymodels](https://www.tidymodels.org/),
|
||||
[rcurl](https://cran.r-project.org/web/packages/RCurl/index.html), and
|
||||
[randomforest](https://cran.r-project.org/web/packages/randomForest/randomForest.pdf) packages
|
||||
from [conda-forge](https://conda-forge.org/feedstock-outputs/index.html)
|
||||
[randomforest](https://cran.r-project.org/web/packages/randomForest/index.html),
|
||||
[rcurl](https://cran.r-project.org/web/packages/RCurl/index.html),
|
||||
[rmarkdown](https://rmarkdown.rstudio.com),
|
||||
[rodbc](https://cran.r-project.org/web/packages/RODBC/index.html),
|
||||
[rsqlite](https://cran.r-project.org/web/packages/RSQLite/index.html),
|
||||
[shiny](https://shiny.rstudio.com/),
|
||||
[tidymodels](https://www.tidymodels.org/),
|
||||
[unixodbc](http://www.unixodbc.org)
|
||||
packages from [conda-forge](https://conda-forge.org/feedstock-outputs/index.html)
|
||||
|
||||
### jupyter/scipy-notebook
|
||||
|
||||
@@ -86,25 +95,38 @@ and versioning strategy.
|
||||
`jupyter/scipy-notebook` includes popular packages from the scientific Python ecosystem.
|
||||
|
||||
- Everything in `jupyter/minimal-notebook` and its ancestor images
|
||||
- [dask](https://dask.org/), [pandas](https://pandas.pydata.org/),
|
||||
[numexpr](https://github.com/pydata/numexpr), [matplotlib](https://matplotlib.org/),
|
||||
[scipy](https://www.scipy.org/), [seaborn](https://seaborn.pydata.org/),
|
||||
[scikit-learn](https://scikit-learn.org/stable/), [scikit-image](https://scikit-image.org),
|
||||
[sympy](https://www.sympy.org/en/index.html), [cython](https://cython.org),
|
||||
[patsy](https://patsy.readthedocs.io/en/latest/),
|
||||
[statsmodel](https://www.statsmodels.org/stable/index.html),
|
||||
- [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/),
|
||||
[bokeh](https://docs.bokeh.org/en/latest/),
|
||||
[bottleneck](https://bottleneck.readthedocs.io/en/latest/),
|
||||
[cloudpickle](https://github.com/cloudpipe/cloudpickle),
|
||||
[dill](https://pypi.org/project/dill/), [numba](https://numba.pydata.org/),
|
||||
[bokeh](https://docs.bokeh.org/en/latest/), [sqlalchemy](https://www.sqlalchemy.org/),
|
||||
[hdf5](https://www.h5py.org), [vincent](https://vincent.readthedocs.io/en/latest/),
|
||||
[beautifulsoup](https://www.crummy.com/software/BeautifulSoup/),
|
||||
[conda-forge::blas=\*=openblas](https://www.openblas.net),
|
||||
[cython](https://cython.org),
|
||||
[dask](https://dask.org/),
|
||||
[dill](https://pypi.org/project/dill/),
|
||||
[h5py](https://www.h5py.org),
|
||||
[matplotlib-base](https://matplotlib.org/),
|
||||
[numba](https://numba.pydata.org/),
|
||||
[numexpr](https://github.com/pydata/numexpr),
|
||||
[pandas](https://pandas.pydata.org/),
|
||||
[patsy](https://patsy.readthedocs.io/en/latest/),
|
||||
[protobuf](https://developers.google.com/protocol-buffers/docs/pythontutorial),
|
||||
[xlrd](https://www.python-excel.org), [bottleneck](https://bottleneck.readthedocs.io/en/latest/),
|
||||
and [pytables](https://www.pytables.org/) packages
|
||||
- [ipywidgets](https://ipywidgets.readthedocs.io/en/stable/) and
|
||||
[ipympl](https://github.com/matplotlib/ipympl) for interactive visualizations and
|
||||
plots in Python notebooks
|
||||
- [Facets](https://github.com/PAIR-code/facets) for visualizing machine learning datasets
|
||||
[pytables](https://www.pytables.org/),
|
||||
[scikit-image](https://scikit-image.org),
|
||||
[scikit-learn](https://scikit-learn.org/stable/),
|
||||
[scipy](https://www.scipy.org/),
|
||||
[seaborn](https://seaborn.pydata.org/),
|
||||
[sqlalchemy](https://www.sqlalchemy.org/),
|
||||
[statsmodel](https://www.statsmodels.org/stable/index.html),
|
||||
[sympy](https://www.sympy.org/en/index.html),
|
||||
[vincent](https://vincent.readthedocs.io/en/latest/),
|
||||
[widgetsnbextension](https://ipywidgets.readthedocs.io/en/latest/user_install.html#installing-in-classic-jupyter-notebook),
|
||||
[xlrd](https://www.python-excel.org)
|
||||
packages
|
||||
- [ipympl](https://github.com/matplotlib/ipympl) and
|
||||
[ipywidgets](https://ipywidgets.readthedocs.io/en/stable/)
|
||||
for interactive visualizations and plots in Python notebooks
|
||||
- [Facets](https://github.com/PAIR-code/facets)
|
||||
for visualizing machine learning datasets
|
||||
|
||||
### jupyter/tensorflow-notebook
|
||||
|
||||
@@ -115,8 +137,7 @@ and versioning strategy.
|
||||
`jupyter/tensorflow-notebook` includes popular Python deep learning libraries.
|
||||
|
||||
- Everything in `jupyter/scipy-notebook` and its ancestor images
|
||||
- [tensorflow](https://www.tensorflow.org/) and [keras](https://keras.io/) machine learning
|
||||
libraries
|
||||
- [tensorflow](https://www.tensorflow.org/) machine learning library
|
||||
|
||||
### jupyter/datascience-notebook
|
||||
|
||||
@@ -129,10 +150,13 @@ communities.
|
||||
|
||||
- Everything in the `jupyter/scipy-notebook` and `jupyter/r-notebook` images, and their ancestor
|
||||
images
|
||||
- [rpy2](https://rpy2.github.io/doc/latest/html/index.html) package
|
||||
- The [Julia](https://julialang.org/) compiler and base environment
|
||||
- [IJulia](https://github.com/JuliaLang/IJulia.jl) to support Julia code in Jupyter notebooks
|
||||
- [HDF5](https://github.com/JuliaIO/HDF5.jl), [Gadfly](https://gadflyjl.org/stable/), and
|
||||
[RDatasets](https://github.com/JuliaStats/RDatasets.jl) packages
|
||||
- [HDF5](https://github.com/JuliaIO/HDF5.jl),
|
||||
[Gadfly](https://gadflyjl.org/stable/),
|
||||
[RDatasets](https://github.com/JuliaStats/RDatasets.jl)
|
||||
packages
|
||||
|
||||
### jupyter/pyspark-notebook
|
||||
|
||||
@@ -144,6 +168,7 @@ communities.
|
||||
|
||||
- Everything in `jupyter/scipy-notebook` and its ancestor images
|
||||
- [Apache Spark](https://spark.apache.org/) with Hadoop binaries
|
||||
- [pyarrow](https://arrow.apache.org/docs/python/) library
|
||||
|
||||
### jupyter/all-spark-notebook
|
||||
|
||||
@@ -155,11 +180,11 @@ communities.
|
||||
|
||||
- Everything in `jupyter/pyspark-notebook` and its ancestor images
|
||||
- [IRKernel](https://irkernel.github.io/) to support R code in Jupyter notebooks
|
||||
- [Apache Toree](https://toree.apache.org/) and
|
||||
[spylon-kernel](https://github.com/vericast/spylon-kernel) to support Scala code in Jupyter
|
||||
notebooks
|
||||
- [ggplot2](https://ggplot2.tidyverse.org), [sparklyr](https://spark.rstudio.com), and
|
||||
[rcurl](https://cran.r-project.org/web/packages/RCurl/index.html) packages
|
||||
- [rcurl](https://cran.r-project.org/web/packages/RCurl/index.html),
|
||||
[sparklyr](https://spark.rstudio.com),
|
||||
[ggplot2](https://ggplot2.tidyverse.org)
|
||||
packages
|
||||
- [spylon-kernel](https://github.com/vericast/spylon-kernel) to support Scala code in Jupyter notebooks
|
||||
|
||||
### Image Relationships
|
||||
|
||||
@@ -173,7 +198,7 @@ diagram](../images/inherit.svg)](http://interactive.blockdiag.com/?compression=d
|
||||
### Builds
|
||||
|
||||
Pull requests to the `jupyter/docker-stacks` repository trigger builds of all images on GitHub
|
||||
Actions. These images are for testing purposes only and are not saved for use. When pull requests
|
||||
Actions. These images are for testing purposes only and are not saved for further use. When pull requests
|
||||
merge to master, all images rebuild on Docker Hub and become available to `docker pull` from
|
||||
Docker Hub.
|
||||
|
||||
@@ -185,14 +210,12 @@ The `latest` tag in each Docker Hub repository tracks the master branch `HEAD` r
|
||||
Every image on Docker Hub also receives a 12-character tag which corresponds with the git commit SHA
|
||||
that triggered the image build. You can inspect the state of the `jupyter/docker-stacks` repository
|
||||
for that commit to review the definition of the image (e.g., images with tag `33add21fab64` were built
|
||||
from
|
||||
<https://github.com/jupyter/docker-stacks/tree/33add21fab64>.
|
||||
from <https://github.com/jupyter/docker-stacks/tree/33add21fab64>.
|
||||
|
||||
You must refer to git-SHA image tags when stability and reproducibility are important in your work.
|
||||
(e.g. `FROM jupyter/scipy-notebook:33add21fab64`,
|
||||
`docker run -it --rm jupyter/scipy-notebook:33add21fab64`). You should only use `latest` when a
|
||||
one-off container instance is acceptable (e.g., you want to briefly try a new library in a
|
||||
notebook).
|
||||
(e.g. `FROM jupyter/scipy-notebook:33add21fab64`, `docker run -it --rm jupyter/scipy-notebook:33add21fab64`).
|
||||
You should only use `latest` when a one-off container instance is acceptable
|
||||
(e.g., you want to briefly try a new library in a notebook).
|
||||
|
||||
## Community Stacks
|
||||
|
||||
|
||||
Reference in New Issue
Block a user