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

Multiple revisions based on feedback.

Browse Source 
Contribution (c) Copyright IBM Corp. 2016
This commit is contained in:
Michael Poplavski
2016-01-12 08:54:24 -06:00
parent 384d524032
commit 943e376fc7
3 changed files with 8 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
minimal-kernel/Dockerfile
View File

@@ -12,12 +12,8 @@ RUN apt-get update && apt-get install -yq --no-install-recommends \
build-essential \
python3-dev \
python3-pip \
ca-certificates \
bzip2 \
unzip \
libsm6 \
python3-zmq \
sudo \
&& apt-get clean
# Install Tini
@@ -26,22 +22,15 @@ RUN wget --quiet https://github.com/krallin/tini/releases/download/v0.6.0/tini &
mv tini /usr/local/bin/tini && \
chmod +x /usr/local/bin/tini
# Configure environment
ENV SHELL /bin/bash
ENV NB_USER nobody
ENV NB_UID 1000
# Install Kernel Gateway
RUN pip3 install jupyter_kernel_gateway==0.2.0
# Configure container startup
USER $NB_USER
USER nobody
EXPOSE 8888
WORKDIR /home/$NB_USER/work
WORKDIR /tmp
ENTRYPOINT ["tini", "--", "jupyter", "kernelgateway"]
CMD ["--KernelGatewayApp.ip=0.0.0.0"]
# Add local files as late as possible to avoid cache busting
USER root
COPY jupyter_kernel_gateway_config.py /home/$NB_USER/.jupyter/
RUN chown -R $NB_USER:users /home/$NB_USER/.jupyter
#error Permission denied: '/nonexistent' when not running as root or as user nobody
USER root

14
minimal-kernel/README.md
View File

@@ -1,12 +1,9 @@
# Kernel Gateway Stack
## What it Gives You
* [Jupyter Kernel Gateway](https://github.com/jupyter-incubator/kernel_gateway) that spawns minimal Jupyter Python kernel
* [Jupyter Kernel Gateway](https://github.com/jupyter-incubator/kernel_gateway) that enables programmatic access to kernels
* No preinstalled scientific computing packages
* Unprivileged user `jovyan` (uid=1000, configurable, see options) in group `users` (gid=100) with ownership over `/home/jovyan`
* [tini](https://github.com/krallin/tini) as the container entrypoint
* Options for Port and Ip address
## Basic Use
@@ -16,9 +13,6 @@ The following command starts a container with the Kernel Gateway server listenin
docker run -d -p 8888:8888 jupyter/minimal-kernel
```
## Docker Options
You may customize the execution of the Docker container and the Notebook server it contains with the following optional arguments.
* `-e INTERFACE=10.10.10.10` - Configures Kernel Gateway to listen on the given interface. Defaults to '0.0.0.0', all interfaces, which is appropriate when running using default bridged Docker networking. When using Docker's `--net=host`, you may wish to use this option to specify a particular network interface.
* `-e PORT=8888` - Configures Kernel Gateway to listen on the given port. Defaults to 8888, which is the port exposed within the Dockerfile for the image. When using Docker's `--net=host`, you may wish to use this option to specify a particular port.
## Docker Options and More Information
* For more information on the Kernel Gateway and its configuration options see the
[Kernel Gateway Repository](https://github.com/jupyter-incubator/kernel_gateway#what-it-gives-you).

7
minimal-kernel/jupyter_kernel_gateway_config.py
View File

@@ -1,7 +0,0 @@
# Copyright (c) Jupyter Development Team.
import os
c = get_config()
c.KernelGatewayApp.ip = os.getenv('INTERFACE', '') or '0.0.0.0'
c.KernelGatewayApp.port = int(os.getenv('PORT', '') or 8888)