Merge branch 'AddinfoForbinder' into 'master'

Added introduction file for binder

See merge request !2

001-Jupyter/001-Tutorials/007-Binder/Introduction.ipynb

+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Presenting your Jupyter notebook on Binder\n",
+    "\n",
+    "Using Jupyter-JSC allows to do great work using Jupyter. A big advantage of Jupyter is that you can easily share your notebooks. These notebooks allow you to add images and descriptions to your code and format it attractively. Since the access to the computers of the JSCs is only allowed with an account, the sharing of your results in form of a Jupyter notebook becomes more difficult. A possible alternative is Binder. Binder provides a platform that allows to build an environment where you can make your own notebook accessible for everyone via a simple link.\n",
+    "\n",
+    "## Binder\n",
+    "\n",
+    "For this you need your own repository (e.g.: GitHub), with the notebook and dependencies. You can specify the dependencies either as requirements.txt or environment.yml. On https://mybinder.org/ you can create a link that builds a Docker image from this repository and executes it for each user in its original form. Binder will always use the latest commit in your choosen branch and rebuild the image in case there is a newer commit. In case of more complicated dependencies it is also possible to have a docker file in your repository. This is then built by Binder. This image must meet certain requirements (https://mybinder.readthedocs.io/en/latest/tutorials/dockerfile.html) to work with binder (e.g.: start of jupyter, with certain options). Fortunately, there are docker images that you can use as a basis for your own work where this is already set up correctly (e.g.: https://hub.docker.com/r/jupyter/minimal-notebook). Binder will build the docker image using the file Dockerfile in the root directory of your repository, a simple one could look like this:\n",
+    "\n",
+    "```\n",
+    "FROM jupyter/minimal-notebook\n",
+    "\n",
+    "USER root\n",
+    "\n",
+    "RUN apt-get update && apt-get install -y \\\n",
+    "    pkg-config \\\n",
+    "    python-dev \\\n",
+    "    python3-mpi4py \\\n",
+    "    \n",
+    "RUN pip install jupyter-server-proxy \\\n",
+    "    mpi4py numpy \\\n",
+    "\n",
+    "COPY --chown=$NB_UID:$NB_GID notebooks/*.ipynb /home/$NB_USER/work/\n",
+    "```\n",
+    "\n",
+    "This would build a docker image with mpi4py and all files ending with .ipynb from the repositories notebooks folder in the working directory of the started jupyter. \n",
+    "\n",
+    "## Limitations\n",
+    "\n",
+    "Because Bidner is free, there are restrictions. The most important limitation is that of memory, each running instance is only entitled to one GB. This limit is not fixed, with available resources of up to 2 GB may be used. But if the resources are not enough or the 2 GB limit is exceeded, Binder quits the kernel of the notebook.\n",
+    "There may also be limitations when building the docker image. Especially if it is a large image with long build times. These limitations can be avoided by building the docker image locally on your computer and then storing it on dockerhub. After that you write a relatively short docker file in the repository connected to binder:\n",
+    "\n",
+    "```\n",
+    "FROM aigro/pvlink-demo:catalyst-small\n",
+    "\n",
+    "COPY --chown=$NB_UID:$NB_GID binder_notebooks/* /home/$NB_USER/work/\n",
+    "```\n",
+    "\n",
+    "In this case also copying the notebooks into the docker image in this last step."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}