From 450894e7630fd9ea7af9e52cc265fb93c6b2645a Mon Sep 17 00:00:00 2001 From: Chris Date: Thu, 14 Nov 2019 11:56:43 +0100 Subject: [PATCH 1/3] removed invalid network parameter --- start-local.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/start-local.sh b/start-local.sh index bc59876..23cccfe 100755 --- a/start-local.sh +++ b/start-local.sh @@ -12,7 +12,7 @@ esac; shift; done # Check if arguments are valid if [[ $PORT != [0-9][0-9][0-9][0-9]* ]]; then echo "Given port is not valid." - echo "Usage: $0 -p [port] -n [docker-network] # port must be an integer with 4 or more digits." + echo "Usage: $0 -p [port] # port must be an integer with 4 or more digits." exit 21 fi @@ -23,5 +23,5 @@ export JUPYTER_PORT=$PORT # echo $JUPYTER_PORT docker-compose up --build -d echo -echo "Started gpu-jupyter via docker-compose on port $JUPYTER_PORT." +echo "Started gpu-jupyter via docker-compose on localhost:$JUPYTER_PORT." echo "See docker-compose logs -f for logs." From 48838347c21d20fce0766bc3de6d41c764105950 Mon Sep 17 00:00:00 2001 From: Chris Date: Thu, 14 Nov 2019 12:04:45 +0100 Subject: [PATCH 2/3] structure and quickstart --- README.md | 43 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 42 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b0e68a7..51f5cff 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,43 @@ # gpu-jupyter -Leverage the power of Jupyter through your NVIDEA GPU and use Tensorflow and Pytorch in collaborative notebooks. +#### Leverage the power of Jupyter and use your NVIDEA GPU and use Tensorflow and Pytorch in collaborative notebooks. + + +## Contents + +1. [Requirements](#requirements) +2. [Quickstart](#quickstart) +3. [Deployment](#deployment-in-the-docker-swarm) +3. [Configuration](#configuration) +4. [Trouble-Shooting](#trouble-shooting) + + +## Requirements + +1. Install [Docker](https://www.docker.com/community-edition#/download) version **1.10.0+** +2. Install [Docker Compose](https://docs.docker.com/compose/install/) version **1.6.0+** + +3. Get access to use your GPU via the CUDA drivers, see this [blog-post](https://medium.com/@christoph.schranz) +4. Clone this repository + ```bash + git clone https://github.com/iot-salzburg/gpu-jupyter.git + cd gpu-jupyter + ``` + +## Quickstart + +As soon as you have access to your GPU locally (it can be tested via a Tensorflow or PyTorch), you can run these commands to start the jupyter notebook via docker-compose: + ```bash + ./start-local.sh + ``` + +This will run jupyter on the default port [localhost:8888](localhost:8888). The general usage is: + ```bash + ./start-local.sh -p [port] # port must be an integer with 4 or more digits. + ``` +In order to stop the local deployment, run: + + ```bash + ./stop-local.sh + ``` + + From 1d2789d82857b4ace97e1c162e81b1b552b0d7e7 Mon Sep 17 00:00:00 2001 From: Chris Date: Thu, 14 Nov 2019 12:14:20 +0100 Subject: [PATCH 3/3] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 51f5cff..ec4481d 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # gpu-jupyter #### Leverage the power of Jupyter and use your NVIDEA GPU and use Tensorflow and Pytorch in collaborative notebooks. +![Jupyterlab Overview](/extra/jupyterlab-overview.png) ## Contents @@ -30,7 +31,7 @@ As soon as you have access to your GPU locally (it can be tested via a Tensorflo ./start-local.sh ``` -This will run jupyter on the default port [localhost:8888](localhost:8888). The general usage is: +This will run jupyter on the default port [localhost:8888](http://localhost:8888). The general usage is: ```bash ./start-local.sh -p [port] # port must be an integer with 4 or more digits. ``` @@ -40,4 +41,5 @@ In order to stop the local deployment, run: ./stop-local.sh ``` + ## Deployment in the Docker Swarm