This is the container image source for the BU Computer Science Jupyter Book infrastructure.
- This repository support running the image locally (fetching it from dockerhub if needed)
- Building the image from scratch
- pull and pushing from the dockerhub
Note: This container does not have any particular book within it. You must clone or copy whatever particular book you want into it. At the bottom you will find a url that should trigger a clone of the Under the Covers - The Secret Life of Software into it.
This container image is available on the MOC operate-first JupyerHub service. To use the container on this service login and start a server with the BU CS Jupyter Book image. You can use this link to directly start it if you don't already have a server running:
https://jupyterhub-opf-jupyterhub.apps.smaug.na.operate-first.cloud/hub/spawn?bu-cs-jupyter-book:latest
- Intel based computer
- Docker installed : https://www.docker.com
- The ability to open a terminal and run make and git in the terminal
- Open a terminal
- clone this respository using git
$ git clone https://github.com/jappavoo/bu-cs-book-dev.git
Cloning into 'bu-cs-book-dev'...
remote: Enumerating objects: 75, done.
remote: Counting objects: 100% (75/75), done.
remote: Compressing objects: 100% (49/49), done.
remote: Total 75 (delta 28), reused 64 (delta 21), pack-reused 0
Unpacking objects: 100% (75/75), 19.31 KiB | 420.00 KiB/s, done.
$
The rest of the instructions assume that you are in the newly created directory of the above command. To get into this directory you need to do the following:
cd bu-cs-book-dev
$ cd bu-cs-book-dev/
$
To start a local container from the image:
make nb
$ make lab
docker run -it --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes -v "/Users/jonathan":"/opt/app-root/src" -p 2222:22 quay.io/jappavoo/bu-cs-book-dev:latest
/usr/local/bin/start-notebook.sh: running hooks in /usr/local/bin/start-notebook.d
...
To access the server, open this file in a browser:
file:///home/jovyan/.local/share/jupyter/runtime/jpserver-9-open.html
Or copy and paste one of these URLs:
http://672be921b600:8888/lab?token=ceadc63909b2eb8b8de5aa7c604480fef3bf2612d34e3ae3
or http://127.0.0.1:8888/lab?token=ceadc63909b2eb8b8de5aa7c604480fef3bf2612d34e3ae3
There will be a lot of information displayed in response to this command. But all we care about is the url on the last line. You should be able to paste it into your web browser and then it will connect the the jupyter-server running within it.
make build
make
- Published pre-built version:
https://quay.io/jappavoo/bu-cs-book-dev:latest - Boston University Course Online Service : be sure to pick
Boston University - Computer Science - Book
https://jupyterhub-redhat-ods-applications.apps.bu-rosa.8pmt.p1.openshiftapps.com/hub/user-redirect/lab - Public open service: RedHat Operate-first JupyterHub Service: be sure to pick
BU CS Jupyter Book
https://jupyterhub-opf-jupyterhub.apps.smaug.na.operate-first.cloud/hub/user-redirect/lab - A book that uses this image:
https://github.com/jappavoo/UndertheCovers - If you have the container running locally you can use the following link to automatically clone a copy of the the above book into the container