diff --git a/dockerfiles/Dockerfile.alpine b/dockerfiles/Dockerfile.alpine new file mode 100644 index 00000000..ab2fb1d5 --- /dev/null +++ b/dockerfiles/Dockerfile.alpine @@ -0,0 +1,11 @@ +FROM python:3.6.3-alpine3.6 + +ARG JUPYTERHUB_VERSION=0.8.1 + +RUN pip3 install --no-cache jupyterhub==${JUPYTERHUB_VERSION} +ENV LANG=en_US.UTF-8 + +USER nobody +CMD ["jupyterhub"] + + diff --git a/dockerfiles/README.md b/dockerfiles/README.md new file mode 100644 index 00000000..e095b85f --- /dev/null +++ b/dockerfiles/README.md @@ -0,0 +1,21 @@ +## What is Dockerfile.alpine +Dockerfile.alpine contains base image for jupyterhub. It does not work independently, but only as part of a full jupyterhub cluster + +## How to use it? + +1. A running configurable-http-proxy, whose API is accessible. +2. A jupyterhub_config file. +3. Authentication and other libraries required by the specific jupyterhub_config file. + + +## Steps to test it outside a cluster + +* start configurable-http-proxy in another container +* specify CONFIGPROXY_AUTH_TOKEN env in both containers +* put both containers on the same network (e.g. docker create network jupyterhub; docker run ... --net jupyterhub) +* tell jupyterhub where CHP is (e.g. c.ConfigurableHTTPProxy.api_url = 'http://chp:8001') +* tell jupyterhub not to start the proxy itself (c.ConfigurableHTTPProxy.should_start = False) +* Use dummy authenticator for ease of testing. Update following in jupyterhub_config file + - c.JupyterHub.authenticator_class = 'dummyauthenticator.DummyAuthenticator' + - c.DummyAuthenticator.password = "your strong password" +